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PREFACE 


This publication describes the operation 
and design of recovery management support 
programs that are part of OS/VS (virtual 
storage): 


e Machine-Check Handler (MCH) 
e Channel-Check Handler (CCH) 
e Dynamic Device Reconfiguration (DDR) 


These programs are designed to keep the 
system operational in the event of a pro- 
cessor, Storage, channel, or device fail- 
ure. (An additional recovery management 
Support program, Alternate Path Retry, is 
described in the OS/VS I/O Supervisor PLM.) 


This publication is divided into three 
parts: MCH, CCH, and DDR. Each part is 
independent of the others and may be used 
aS a separate manual, although the parts 
Share a table of contents and an index. 
Each part of the manual is divided into the 
following sections: 


Section 1: Introduction summarizes the 
functions and operations of the program. 
This section also contains definitions 
needed to understand the rest of the part. 


Section 2: Method of Operation 
describes the functions of the program in 


detail and relates the functions to the 
coding. The functions are described mainly 
through method of operation diagrams, which 
also refer to the coding. 


Section 3: Program Organization 
describes the program from a module or rou- 


tine point of view. Overall flow diagrams 


Show the relationship of the modules; 
module descriptions show the logic of each 
module. 


Section 4: Directory is a guide to the 
named areas of coding. 


Section 5; Data Areas describes the 
fields of information used by the program. 


Section 6: Diaqnostic Aids contains 
techniques and information to use in deter- 


wining the source of problems that arise in 
the program. 


Appendix A: Missing Interruption Check- 
er contains an explanation and method of 
operation diagram showing how recovery 
anagement checks for missing device 
interruptions. 


This publication is intended to be used 
aS a guide to the program listings. The 
intended audience is system maintenance 
personnel, including customer engineers, 
programming support representatives, and 
system programmers. 


This publication assumes an understand- 
ing of OS/VS, including paging and I/O 
operation. Information on these subjects 
can re found in introductory OS/VS publica- 
tions as well as in: 


OS/VS Supervisor Logic 


OS/VS I/O Supervisor Logic 
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MACHINE-CHECK HANDLER 


a 


PURPOSE OF MCH 


MCH (Machine-Check Handler) minimizes 
the computing time lost due to machine mal- 
functions. MCH does this by correcting 
certain malfunctions and by producing diag- 
nostic records and messages to help system 
Maintenance personnel find the cause of the 
problem. 


OVERVIEW OF MCH 


A machine malfunction can originate from 
the CPU, real storage, or control storage. 
When any of these fails to work properly, 
the machine attempts to correct the mal- 
function (see Figure MCH-1). If the 
machine corrects the malfunction, it noti- 
fies MCH by a machine-check interruption. 
MCH records the fact that the machine has 
failed to operate properly (except when the 
machine iS in quiet mode; see “Recording 
and Quiet Modes" in this section.) When 
the machine-check interruption occurs, the 
CPU logs out fields of information in real 
Storage detailing the cause and nature of 
the error. The model-independent data is 
stored in the fixed logout area, and the 
model-dependent data is stored in the 
extended logout area. MCH uses these 
fields to analyze the error and to produce 
an error record. 


If the machine fails to correct the mal- 
function through hardware recovery facili- 
ties, the machine still causes a machine- 
check interruption and logs out. In this 
case, however, the fixed logout contains an 
interruption code indicating an unsuccess- 
ful recovery attempt. MCH then analyzes 
the data and attempts to keep the system as 
fully operational as possible. The loca- 
tion and cause of the malfunction determine 
what action MCH takes: (1) resumes system 
Operations; (2) resumes system operations 
at the expense of the task that was inter- 
rupted; (3) places the system in the wait 
State. MCH always records as much informa- 
tion about the error as possible. 


SYSTEM/370 RECOVERY FEATURES 


Because the operation of MCH depends on 
certain recovery actions taken by the 
machine and on the information given to it 
by the machine, some of the features of the 
machine are described here. For a more 
complete description, see System/370 Prin- 
ciples of Operation. 
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Automatic Recovery Features 


System/370 has two built-in methods of 
recovering from machine malfunctions: HIR 
(hardware instruction retry) and ECC (error 
checking and correction). Whenever poss- 
ible, HIR and ECC recover from machine mal- 
functions without assistance from MCH. The 
HIR feature allows the machine to recover 
from temporary CPU failures that would 
otherwise make it necessary to reload the 
operating system or terminate the executing 
program. ECC detects and often corrects 
invalid data fetched from real and control 
storage. 


Hardware Instruction Retry 


HIR microprogram routines automatically 
retry CPU errors. These routines save 
source data before it is altered by an 
operation. When an error is detected, a 
mMicroprogram returns the CPU to the begin- 
ning of the operation, or to a point where 
the operation was executing correctly, and 
the operation is repeated. After eight 
unsuccessful retries by HIR, the error is 
considered permanent. 


Error Checking and Correction 


ECC routines check the validity of data 
fetched from real and control storage. 
Data enters and leaves real or control 
storage through a storage adapter unit. 
This unit checks each doubleword for 
correct parity in each byte. If a single- 
bit error is detected, it is corrected. 
The corrected doubleword is then sent back 
into real or control storage and on to the 
CPU (except on the Model 145). MCH is 
notified by a machine-check interruption 
and finds the address of the error in the 
fixed logout. 


ECC does not correct multiple-bit 
errors, but notifies MCH by a machine-check 
interruption. MCH finds the address of the 
error in the fixed logout and attempts to 
recover from the error. 


Fixed Storage Areas 


There are four fixed areas of real 
storage for System/370: 


e Permanent storage assignment (decimal 
locations 0-159) 
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e I/O communications area (decimal loca- 
tions 160-191) 


e Fixed logout area (decimal locations 
232-511) 


e Extended logout area (begins at loca- 
tion 512 unless the address in control 
register 15 specifies otherwise) 


The fixed storage areas are described in 
MCH Section 5. 


Fixed Logout Area 


Data is put into the fixed logout area 
when any machine-check interruption occurs. 
This area contains data that is model inde- 
pendent, although not all models use every 
field. The fixed logout area contains the 
machine-check interruption code, which 
indicates the reason for the interruption; 
system status information; and the contents 
of the general-purpose, floating-point, and 
control registers at the time of the 
machine~check interruption. This data is 
processed by MCH. 


Extended Logout Area 


The extended logout area contains data 
that is model dependent. It begins at 
address 512 or at the address specified in 
control register 15. The length of the 
extended logout area is different for each 
model. If the extended logout mask bit 
(MCEL bit) in control register 14 is 
enabled, data is written into the extended 
logout area for all types of machine-check 
interruptions. This data is recorded by 
MCH in the SYS1.LOGREC data set. 


The size of the logout areas for each 
CPU model is shown in Figure MCH-2. 


Control Registers 


MCH uses two control registers for load- 
ing and storing control information. Con- 
trol register 14 contains mask bits that 
(1) indicate whether certain conditions can 
cause machine-check interruptions and (2) 
control conditions under which an extended 
logout can occur. Control register 15 con- 
tains the address of the extended logout 
area. 


The control registers are referred to by 
MCH through the use of two privileged 
instructions: LOAD CONTROL and STORE CON- 
TROL. LOAD CONTROL is used to move infor- 
WMation from real storage to control regis- 
ters; STORE CONTROL is used to move infor- 
mation from control registers to real 
storage. 


ar 


C Figure MCH-3. 
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Figure MCH-2. 


Figure MCH-3 shows control register 14. 
System/370 Principles of Operation contains 
a detailed description of the use of the 
control registers and shows the masks used 
to prevent logouts and machine-check 
interruptions. 


Recording and Quiet Modes 


Hardware instruction retry and error 
checking and correction can operate in two 
modes: recording and quiet. In recording 
mode, a machine-check interruption occurs 
for each malfunction. In quiet mode, a 
machine-check interruption Occurs only for 
malfunctions that were not corrected by HIR 
or ECC. Recording mode is the normal mode 
of operation for Models 155 and 165II. All 
other supported CPU models normally run in 
recording mode for HIR and quiet mode for 
ECC. Quiet mode is usually used when there 
is a large number of corrected errors. 

When in recording mode, a threshold value 
of 12 is used by MCH to define the number 
of interruptions allowed for corrected 
errors. When the number of corrected 
errors exceeds this threshold, quiet mode 
is entered automatically, and no more 
interruptions occur for corrected errors. 
The operator can use the MODE command to 
switch from recording mode to quiet mode or 
from quiet mode to recording mode. The 
current mode can be determined by using the 
STATUS operand of the MODE command. 


MCH ERROR RECOVERY 
Machine-check interruptions can be clas- 


sified as either soft or hard. A soft 
machine~check interruption indicates to MCH 
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Fixed and extended logout area sizes 


that the hardware has already corrected the 
error. MCH makes a record of the event and 
the circumstances under which it occurred. 

A hard machine-check interruption indicates 
to MCH that the hardware has not corrected 

the malfunction and MCH must try to recover 
from it. 


Soft Interruptions 


After the machine has recovered from a 
machine check (assuming that it is operat- 
ing in recording mode), a machine-check 
interruption occurs. From the machine- 
check interruption code, MCH determines 
that the error has been corrected, and 
therefore recovery by MCH is not necessary. 
MCH must, however, check whether a change 
to quiet mode is necessary and prepare a 
recovery report. 


Hard Interruptions 


When HIR or ECC facilities have not been 
able to correct an error, MCH tries to 
enable the system to continue processing. 

A hard machine-check interruption occurs on 
any of the following conditions: 


e System damage 

e Instruction processing damage 
e Timing facility damage 

° Buffer damage 


e High resolution timer damage (location 
80) 


e External damage (when associated with 
timing damage) 


e Power warning. 


Depending on the type of malfunction 
that caused the interruption and the status 
of the system at the time of the interrup- 
tion, MCH (1) resumes system operations; or 
(2) resumes system Operations at the 
expense of the task that was interrupted; 
or (3) places the system in the wait state. 


Levels of Error Recovery 


Recovery from machine malfunctions can 
be divided into four categories: 
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Task recovery 

System recovery 
System-Supported restart 
System repair 


Task recovery is most acceptable; system 
repair is least acceptable. 


Task Recovery 


Task recovery is transparent to the 
interrupted program. This type of recovery 
can be made by either HIR or ECC, or by 
MCH. Task recovery by MCH is made by 
correcting SPF (storage protection feature) 
keys and intermittent errors in real 
storage. 


System Recovery 


System recovery is attempted when task 
recovery is impossible. System recovery is 
the continuation of system operations at 
the expense of the task (and subtasks if 
attached) in which the error appeared. 
task containing the error is terminated 
either by abnormally ending the task or by 
marking it nondispatchable. System reco- 
very can take place only if the task in 
question is not required for system 
operation. 


The 


System-Supported Restart 


System-sSsupported restart is tried after 
task and system recovery have failed or 
when they could not be tried. This occurs 
when a task required for system operation 
contains an error. The operator is noti- 
fied that the system cannot continue to 
Operate and has been placed in a wait 
State. He must then reload the system. 


Note: System-supported restart is a warm- 
start operation; that is, the remaining 
information on the job queue is usable. 
The job queue does not have to be rebuilt. 


System Repair (Manual) 


System repair also occurs when the sys- 
tem has Eeen placed in a wait state, but it 
requires the services of maintenance fper- 
sonnel and takes place at the discretion of 
the operator. Usually, the operator will 
have already tried to recover by system- 
supported restart one or more times without 
success. System repair is required, for 
example, if a hard error occurs so fre- 
quently that system-supported restart is 
not successful. 


&. 


This section describes the functions of 
MCH and how MCH performs these functions. 
Many references are provided to material in 
other sections of this publication and to 
the MCH program listing. Two types of 
information are presented: 


e Text that discusses the design of MCH. 


e Method of operation diagrams that show 
the functions performed by MCH in the 
order that they occur. The module name 
and label of each processing step are 
included in the implementation notes 
for each diagram. These diagrams can 
be used for guick reference when 
reviewing MCH functions. Diagram MCH-1 
shows how the method of operation dia- 
grams for MCH are organized. 


THE LOGIC OF MCH 


MCH has two basic paths of execution: 
one for malfunctions that have been 
corrected by HIR or ECC (soft interrup- 
tions), and one for malfunctions that have 
not been corrected by those facilities 
(hard interruptions). 


For uncorrected failures, MCH goes 
through four major operations: 


Preservation of the system environment 
Analysis of the malfunction 

Program damage recovery 

Recording and termination 


For malfunctions that have been corrected 
by HIR or ECC, the program damage recovery 
step is omitted. In addition to the four 
steps mentioned above, MCH controls whether 
the machine operates in recording or quiet 
mode. 


COMMUNICATIONS 


In order to process a machine-check 
interruption, MCH must have certain data 
describing the failure. For this purpose, 
the CPU provides a logout which gives MCH 
the information needed to properly analyze 
the error and determine how to handle it. 
After the model-independent logout is pro- 
duced, MCH moves it into the MCH record 
puffer, where it is used by the transient 
modules of MCH to communicate with each 
other. (Since MCH uses an overlay scheme, 
it iS necessary to store information in an 
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area that will not be overlaid by the next 
module brought into the transient area.) 
The MCH Nucleus also uses the common area 
to store and retrieve data about the fai- 
lure. The common area is described in MCH 
Section 5. 


PRESERVATION OF THE SYSTEM ENVIRONMENT 


MCH normally receives control through a 
machine-check interruption. If another 
machine-check interruption were to occur 
while MCH was being executed, control would 
be returned to the beginning of MCH. Thus 
the first machine-check interruption would 
never be processed, since the information 
about it in the logout areas would be lost. 
TO minimize this possibility, MCH receives 
control with the system disabled for furth- 
er interruptions. Disabling, however, is 
only a temporary measure to give the MCH 
Nucleus time to make the following emergen- 
cy provisions: 


e It disables for machine-check interrup- 
tions which have already been corrected 
Ey HIR or ECC, so that only serious 
errors can interrupt MCH. If the error 
being handled has not been corrected, 
there is no need to interrupt MCH to 
report a less serious error. If the 
error being handled has been corrected, 
there is no need for one corrected 
error to have priority over another. 


e It saves the contents of the fixed 
logout area in the MCH record buffer. 
If a hard machine-check interruption 
occurs now, the original data is not 
overlaid. Also, extended logouts are 
prevented by setting a mask in control 
register 14, so that the extended 
logout area is not overlaid. 


e It saves the machine-check old PSW. 
Then, if a second error occurs, causing 
the current PSW to replace the old PSW, 
control can be returned to the program 
that was interrupted first (provided 
that the error was corrected with the 
original system status intact). 


e It alters the address in the machine- 
check new PSW and the program-check new 
PSW to point to the MCH SHUT (Special 
Handler for Unusual Termination) rou- 
tine. Then, if a second error occurs, 
control is passed to the SHUT routine, 
rather than to the beginning of MCH. 
This is done because a second machine- 
check interruption indicates that the 
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Pa a ee ae eee Pee y~----------------------- 
[ Error Condition | Special Circumstances 

i te oh 4 
f Hard on Soft | Error within MCH | 
| | 

| | | 
| | | 

| | | 
| | | 
| | | 
}----------------- +--~-------------------- + 
| Hard on Hard [ Recovery made from | 
i | original error i 
| |-------—--------------- t 
| | Recovery not made | 
| | from original error | 
|----------------- st eS ee 4 
| Note: MCH is not enabled for soft errors 
| or hard errors. 
| control. 


be ee ee oe ee ee eee 


Determines the severity of the error. 
any error other than system damage, 
attempts to record the original error and 
return control to the point of interrup- 
tion. The occurrence of another hard error 
during this attempt will result in a wait 
State, with a message if possible. 

Attempts to record the original error and 
returns control to the systen. 

Places the system in a disabled wait state 
and notifies the operator. 


at any time during the processing of soft 


MCH is only reenabled for soft errors after the recorder gets 


— > a oe ee oe ee 9 ee se ee we we eS wwe OS! See 


Figure MCH-4. MCH responses to error-on-error conditions 


error occurred during MCH execution. 
MCH would go into a loop if the 
machine-check new PSW were not altered 
and the second error occurred. Also, 
when an error occurs within MCH, MCH is 
operating in a degraded state and might 
not be able to recover from the origin- 
al error. 


It enables hard machine-check interrup- 
tions to give them priority over soft 
machine-check interruptions. 


There is always the danger of the 
machine failing immediately after MCH is 
entered, while the system is disabled for 
interruptions. If this happens, the 
machine comes to a hard stop, no instruc- 
tions are executed, and no interruptions 
occur. System operation can be continued 
only by means of a system reset or IPL. 
Figure MCH-4 shows MCH responses to various 
error-on-error conditions. 


MCH saves the fixed logout, extended 
logout, and the machine-check old PSW to 
protect them from a second interruption. 
Once the system has been reenabled for 
interruptions, MCH saves the permanent 
storage assignment. The four data areas 
are saved in the following locations: 

e Fixed logout: address contained in the 
RVTINLOG field of the RVT. 
Extended logout: address found in con- 
trol register 15. 


e Machine-Check old PSW: MCHRPSW in the 
MCH common area. 

e Permanent storage assignment: MCHPSA 
in the MCH common area. 


Figures MCH-5 and MCH-6 show the MCH 
environment before and after 
initialization. 


ANALYSIS OF THE FAILURE 


To accurately assess the extent of the 
damage at the time of the machine-check 
interruption, MCH analyzes the machine- 
check interruption code. MCH identifies 
the type of error, where it occurred, and 
under what special circumstances it 
occurred, if any. 


Figure MCH-7 shows the fields of the 
interruption code and which fields are use 
by each System/370 model. See MCH Section 
5 for a complete description of the 
machine-check interruption code. 


Some of the major fields of the machine- 


check interruption code are: 


e Machine Check Subclasses: Bits 0 
through 8, the subclasses, indicate th 
machine-check condition causing the 
interruption. 
least one of these bits must be set. 
If more than one error has occurred, 
several bits may be set. 


Tense: 
of the interruption. For example, if 
bit 14 is set to 1, the machine-check 
old PSW contains the address of the 
instruction in which the error 
occurred. 
0, the machine-check old PSW contains 
the address of an instruction beyond 
the point of error. 


Storage Errors: This field indicates 
that the error was in real storage. 


d 


e 


On each interruption, at 


This field indicates the timing 


If bits 14 and 15 are set to 


C 


c 


C 


Machine-Check New PSW 
Current PSW 





Figure 


Control Register 15 


Figure 


Machine-Check Old PSW 


Control Register 15 


MCH-5. 


Program-Check New PSW 


Machine-Check New PSW 


Current PSW 
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MACHINE-CHECK HANDLER 


MCH Nucleus 


SHUT Routine 


Program about to 
be interrupted MCH Transient Area 





MCH Common Area 


Fixed Logout 


Extended Logout 





MCH and environment before a machine-check interruption 


MACHINE-CHECK HANDLER 


Hardware Error SHUT Routine 
Analysis Function 
MCH Transient Area 





Interrupted 
Program 








MCH Common Area 






Machine-Check Old PSW MCHRPSW 









Original Fixed Logout Saved Copy of Fixed Logout 


Extended Logout 


MCH after the environment has been saved following a machine-check 
interruption 
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‘Model 
135 


145 


155 
158 


165 
168 


Figure 


Machine-Check Interruption Code 


0 
S|P ISTIC say V} MIP 
~ialelelel 





























Subclass 

Time of interruption occurrence 
Storage errors 

Validity 

Not assigned 


20-25, 27-31, 46, 47 
6, 9-13, 19, 26, 32-45 


Note: The fields of the machine-check interruption code 
are fully explained in MCH Section 5. 


MCH-7 e 
by each System/370 model 


Validity: The validity bits represent 
the various fields stored during 
machine-check interruption. Any bit 
that is 0 indicates that the associated 
data (general registers, condition 
code, etc.) has been affected by the 
error. 


Extended Logout Length: This field 
indicates the length in bytes of the 
extended logout area. 


Types of Failures 


The following types of failures can be 


identified from the machine-check interrup- 
tion code: 
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System damage: An error occurred that 
could not be attributed to the instruc- 
tion referred to by the machine-check 
old PSW. 


Instruction processing damage: An 
error occurred during the processing of 
the instruction indicated by the 
machine-check old PSW. The instruction 
was either unretryable or unsuccessful- 
ly retried, or the damage resulted from 
a multiple-bit failure in real storage 
or an SPF key error. 


Hardware retry successful (soft error): 
The CPU instruction was successfully 
retried. 


ECC successful (soft error): A single- 
bit storage error was corrected by ECC. 


Time facility damage: An error 
occurred in the time-of-day clock, mak- 
ing it invalid for time stamping. 


Timer damage: The high resolution timer 
at location 80 contains a parity error. 


Machine - Check 
Extended Logout Length 








Fields of the machine-check interruption code and which fields are used 


e Power warning: Loss of power to the 
system may be impending. 


System Damage 


System damage occurs when the circuitry 
or the microcode in the CPU has failed. 
Multiple-bit errors in control storage are 
included in this category. By presenting 
the failure as system damage in the 
machine-check interruption code, the 
machine informs MCH that system operation 
must stop. In this case the MCH Nucleus 
places the system in the wait state. 


Instruction Processing Damage 


Any type of instruction processing 
damage has some program damage associated 
with it. MCH must therefore ultimately 
associate the error with a system or user 
task and then take whatever action is 
necessary to keep the system running. The 
first step is to determine from the inter- 
ruption code the type of error that 
occurred. 


There are three types of failures that 
are classified as instruction processing 
damage. Bit one, the instruction proces- 
Sing damage bit, is set to one in all 
cases. Related bit settings indicate the 
type of instruction processing damage that 
occurred. 


® Processor damage: This condition is 
indicated when the instruction proces- 
Sing damage bit is on and the error is 
neither a multiple-bit error nor an SPF 
key error. Since the PSW is pointing 
to the failing instruction and the 
instruction address is valid, MCH 


C 


assumes that the CPU retried the 
instruction but was not successful. 


e Multiple-bit error in real storage: 
MCH determines whether this type of 
error is solid or intermittent by find- 
ing the location of the error and doing 
a series of stores and fetches using 
that location. If another machine- 
check interruption occurs, the error is 
solid. Otherwise it is considered 
intermittent. 


Since a valid machine-check interrup- 
tion must be anticipated each time data 
is fetched from or stored into the 
location, the address in the machine- 
check new PSW is altered to point toa 
routine that services the expected 
interruption. The result of this ana- 
lysis is placed in the MCH common area. 
Later, MCH uses this information to 
assess the damage to the task occupying 
that failing section of real storage. 


e SPF key error: The severity of an SPF 
key error is determined in a way simi- 
lar to that used for the multiple-bit 
storage error. The machine-check new 
PSW is made to point to a routine that 
will service the expected machine-check 
interruption. A succession of fetches 
and stores uSing all possible key pat- 
terns is made to determine whether the 
error is solid or intermittent. The 
result of this analysis is placed in 
the MCH common area. 


PROGRAM DAMAGE RECOVERY 


Having identified the hardware charac- 
teristics of the failure, MCH determines 
the effect of the failure on the operating 
System. The effect of the failure primari- 
ly depends on whether it occurred in the 
processor, real storage, or an SPF key. If 
there was a failure, of any type, ona 
model not supported by MCH, the path of 
execution that is taken is always the one 
described here under “Processor Failures." 


Processor Failures 


For a processor failure (or a failure in 
a model not supported by MCH) either MCH 
places the system in the wait state, or the 
ABTERM routine terminates the job-step 
task. MCH places the system in the wait 
state for one of two reasons: 


e The failure affected an indispensable 
system task. If, in the machine-check 


old PSW, the system was disabled for 

I/O interruptions while in supervisor 
state at the time of the interruption, 
MCH assumes that critical system acti- 


vity was in progress and that to con- 
tinue system activity would only cause 
further damage to the system. 


e The status of the system at the time of 
the failure is unknown. If the wait 


TCB is active, MCH cannot analyze 
further and must assume that the inte- 
grity of any further processing cannot 
be maintained. 


If the task is not indispensable and the 
status of the system is known, MCH deter- 
mines whether the task in control alone is 
damaged, in which case the task could he 
terminated without affecting system 
operations. 


Real Storage Failures 


Just as for processor failures, if the 
storage failure appears in an indispensable 
system task or if the status of the system 
is unknown, the system must be terminated. 
The system must also be terminated if: 


e The failure was anywhere in the VS 
nucleus. 


e The failure was in the SQA (system 
queue area), PQA (paging queue area), 
or LSQA. 


If the failure was in none of these, MCH 
determines if it occurred in a pageable 
area, nonpageable area, or in a fixed page, 
and indicates in the page table that the 
page is invalid or unavailable. Later, 
when that page is referred to, a paging 
exception occurs and the paging supervisor 
brings in the back-up copy of the page. 


This procedure occurs only if MCH deter- 
mines that the page containing the failure 
has not keen changed. If it has been 
changed, the task must be terminated by 
ABEND. If it has not been changed, the job 
is reassigned a new real page, and the 
instruction is automatically reexecuted. 
However, MCH still must determine what to 
do with the page containing the failure. 
For solid failures, MCH degueues the real 
page from the table of available pages, 
making it permanently unavailable. For 
intermittent failures, MCH takes no further 
action. 


SPF Key Failures 


SPF keys that fail intermittently are 
reset to their original value to permit the 
system to continue operation. For solid 
errors, the same conditions that apply to 
storage errors apply to SPF key errors. 


Figure MCH-8 shows the conditions and 
corresponding actions taken by MCH. 
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CONDITION 


Type of error 
Storage 





Storage Protect Key 





Processor 


Extent 
Solid 


Intermittent 


Location 
Pageable area 


Nucleus/SQA/PQA/LSQA 


Fixed page (nonpageable) area 





Status of PSW at MCI 


Supervisor mode 





Problem program mode 
Wait mode 


I/O masking 
Enabled 


Disabled 


fe See 


Task nature 
Critical 


Non-critical 


Storage state 


Changed 
Unchanged 


Recursion in MCH 


ACTION TAKEN 


Make real page permanently 
unallocatable 


x x x 
x x x 





Invalidate Page Table Entry 


Repair SPF key 
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Note: When more than one condition of a type is indicated (encircled x's), the action is the same no matter which condition represents the situation. 


For example, in column 6 both solid and intermittent are indicated to show that any storage error (solid or intermittent) in the Nucleus, SQA, PQA, 





or LSQA results in MCH placing the system in a disabled wait state after using the Emergency Recorder. 


Figure MCH-8. 
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Actions taken by MCH 
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RECORDING AND TERMINATION Error Recording 


= The 


MCH produces two kinds of error records: 





recording function of MCH has two the short record and the long record; both 
parts. The first is formatting an error are shown in Figure MCH-9. MCH formats the 
record and later writing it into the SYS1. error record before it terminates its 
LOGREC data set. The second 1s emergency operations. Writing the record into SYS1. 
recording; that is, the recording MCH does LOGREC takes place after MCH terminates to 
when it has determined that system opera- decrease the chances of a second machine- 
tion cannot continue. check interruption occurring while MCH is 
From 
From bytes 0-79, 
- MCHABREC From From MCHDALEN- 
field of MCH Locations Locations MCHPDARI 
Independent 232-511 5 12-(variable) fields of MCH 
Common Area Independent 
Common Area 
MCH . 
R d amage 
ch ABREC Fixed Logout Extended Logout Assessment 
Area Field 
MCH records are built here before writing them to SYS$1.LOGREC. 
7 ee es 
ey 
Short Pi ABREC i 
R d 
Scot Le ee ee es 
a es ee ee ee ee ee ee ee en ee ee ee ee ee ee ee ee ee ee 
MCH Damage | 
Long ABREC Fixed Logout Extended Logout Assessment J 
Record Field J 
me se ee ee ee ee ee ee ee a ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 
ae a se ee ee ee ee ee ee ee es ee 
MCH Damage | 
Long ABREC Fixed Logout Assessment | 
Record Field 


When there is not an extended logout. 


A full ABREC is 70 bytes long and consists of: 


0 













From Location 232 





Sess 





From MCH Independent Common Area 





The full ABREC is included in an MCH short record, but only the first 48 bytes are included in an MCH long record because the MCIC is part of the fixed 
logout, and MCHDAMAG and MCHFSAR are part of the damage assessment field. 


( Figure MCH-9. MCH record format 
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being executed. Further, the system is in 
quiet mode from the time MCH exits until 
the recording occurs. 


MCH does the following to put a record 
into the SYS1.LOGREC data set: 


e Formats the complete error record. 


e Activates the system communications 
task in order for it to load the MCH 
Error Recorder. 


e Terminates itself by relinquishing con- 
trol to the operating system dispatcher 
or the interrupted program. 


If the dispatcher gets control it dis- 
patches the next ready task, which should 
be the system communications task. It 
brings in the MCH Error Recorder, which 
then writes the MCH records into the SYS1. 
LOGREC data set. 


If another hard machine-check interrup- 
tion occurs before the error record is 
written, the MCH Error Recorder writes the 
short record of the first interruption and 
the complete record of the second interrup- 
tion. If a third interruption occurs after 
the record is formatted but before it is 
written, the short record of the first and 
second interruptions and the complete reco- 
rd of the third interruption are recorded. 


When more than three hard machine-check 
interruptions occur before the MCH Error 
Recorder has a chance to write the records 
into SYS1.LOGREC, the record having the 
lowest priority is overlaid. The "lost 
summary" field in the record is updated to 
show the location and severity of the lost 
record. The priority of machine checks is: 


1. Hard unrecovered (task terminated) 
2. Hard recovered (task recovered) 
3% Soft 


The MCHDAMAG field of the MCH error 
record reflects the error analysis and 
action taken by MCH. The field is model 
independent, and some bits do not apply to 
every model. Specifically, the buffer and 
control storage bits are not set for all 
models. 


In addition, some recovery management 
action bits in this field are not set for 
all models. The repair bit is set if MCH 
has repaired an SPF key failure. The 
storage reconfigure bit is set if MCH has 
performed some type of real storage recon- 
figuration. The buffer reconfigure bit is 
set if MCH has performed some type of buff- 
er reconfiguration. The setting of any of 
these bits indicates that MCH has rerformed 
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the indicated action but does not imply 
that MCH was able to resume the task that 
was in error. For example, task or system 
termination may be necessary if the retry 
was unsuccessful, a valid return point to 
the interrupted program is not available, 
or an instruction is nonretryable. 


The recovery management information area 
of the field indicates hardware logging of 
the error. 


Finally, for certain machine-check 
interruptions, MCH makes an early deter- 
ination that system termination is neces- 
Sary and so does not perform any further 
analysis as to type of error or area of 
damage. In these cases, only the termina- 
tion bit and possibly a system down code in 
the recovery management information area of 
the field are set. 


Emergency Recording 


Emergency recording is necessary when 
the system cannot continue to operate, 
because of either a CCH catastrophic condi- 
tion or a machine-check interruption unre- 
coverable condition. Instead of giving 
control to the operating system to write 
the error record, since the system is known 
to be unreliable, MCH writes it. The MCH 
Emergency Recorder determines whether there 
is a CCH record to be written and if so 
writes the record. MCH then determines the 
number of records formatted in the buffer 
and whether there is room in SYS1.LOGREC to 
record them. The writing is done by the 
Module Loader in the MCH Nucleus. When the 
error records have been placed in SYS1. 
LOGREC, control is given to the SHUT rou- 
tine to attempt to write a message to the 
Operator informing him of the status of the 
error and to terminate the systen. 


Interface with the Channel-Check Handler 


Either of the following causes MCH to 
receive control from the Channel-Check 
Handler (CCH): 


e A machine-check interruption occurs 
during CCH execution. 


e CCH determines that the operating sys- 
tem must be terminated. 


When CCH is entered, it sets RVTWSMCC in 
RVTWSFLO of the recovery vector table. 
This indicates to MCH, when a machine-check 
interruption occurs, that CCH is the 
affected program and that the system must 
ke terminated. 


When CCH determines that the system must 
be terminated because of a channel error, 
it: 


1. Constructs a full channel inboard 
record and places the address of this 
record in RVTCCHRC. 


2. Sets RVTWSCIO in RVTWSFLO to indicate 
that CCH has created a record to be 
written and that the system must be 
terminated because of a channel error. 

3. Sets wait state code in MCHIBUF. 


4. Uses the address in RVTSHUT to pass 
control to SHUT. 


MCH places the system in a wait state 
with a code passed in MCHIBUF. 
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MCH METHOD OF OPERATION DIAGRAMS 


These Method of Operation Diagrams show 
the functions of MCH and relate these func- 
tions to the exact modules and entry points 
in the code where they are performed. 


These particular diagrams are known as 
HIPO diagrams because they show Hierarchy 
as well as Input, Processing, and Output. 
The first diagram is a visual table of con- 
tents. The rest of the diagrams are 
arranged in a hierarchy according to the 
level of detail. 


Read the diagrams left to right, input- 
procesSing-output. The processing steps 
are numbered sequentially; these numbers 
also refer to the implementation notes at 
the bottom of most of the diagrams. The 
notes contain additional information about 
the processing steps. 


The arrows are used as follows: 


> =. control flow to or from 
another program. 
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Primary processing fiow. Shows 
the path followed to accomplish 
the principal function of the 
body of code. 


[———_|> pata transfer. Indicates that 


Gata is moved from one location 
to another. 


Control information transfer. 
Indicates the setting or changing 

CN of switches or pointers that will 
be used to determine the course 
of future processing. 


Pointer. Indicates that a field 

> in one data area contains an 
address that points to another 
field or data area. 


Data reference. Indicates that 
the contents of a data area are 

==-—— tested or read in order to deter- 
mine the course of subsequent 
processing. 
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PHYSICAL CHARACTERISTICS OF MCH 


Overlay Structure of MCH 


MCH has an overlay structure; some parts 
of the program, called resident modules, 
remain in real storage and other parts, 
called transient modules, are in real 
Storage only when they are being used. The 
transient modules are stored in the SYS1. 
SVCLIB data set. 


Loading Transient Modules in a System with 
192K or More Bytes of Real Storage 


In a VS1 system with a real storage size 
equal to or greater than 192K bytes, or in 
any VS2 system, the 1K MCH transient area 
is a fixed part of the nonpageable portion 
of storage. 


When MCH is not being used, the Soft 
Machine-Check Handler (SMCH) occupies the 
transient area. SMCH is a module that 
handles the model-dependent portions of 
soft machine-check interruptions. Having 
SMCH reside in the transient area eli- 
minates the need to bring in modules from 
auxiliary storage when a soft machine-check 
interruption occurs. 


When a hard machine-check interruption 
occurs, and the MCH Nucleus determines that 
transient modules are needed to continue 
processing the machine-check interruption, 
the MCH Nucleus passes control to the MCH 
I/O Control module (IGFVMCE4) to bring in 
the necessary transient modules from SYS1. 
SVCLIB. The first module brought into the 
transient area then overlays SMCH. 


When a transient module finishes execu- 
tion, it determines which transient module 
will succeed it, and specifies the succes- 
sor module to the MCH I/O Control module. 
The MCH I/O Control module then transfers 
control to the I/O supervisor, which loads 
the next module into the transient area. 
After all processing has been completed, 
SMCH is loaded into the transient area. 
Except for system termination, SMCH is 
always the final successor module, since it 
must be resident when MCH is again given 
control. When the system must be ter- 
Minated, the Emergency Recorder is the last 
module in the transient area. 
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Loading Transient Modules in a System with 
Less Than 192K Bytes of Real Storage 


In a VS1 system with a real storage size 
of less than 192K bytes, the MCH transient 
area and the MCH I/O Control module reside 
on a 2K page instead of in real storage. 
SMCH is the transient area. 


When a machine-check interruption 
occurs, and the MCH Nucleus determines 
which transient modules are needed to con- 
tinue processing the machine-check inter- 
ruption, control is given to a paging 
interface module which is part of the Pag- 
ing Supervisor. This module fixes the 2K 
page with the MCH transient area and the 
MCH I/O Control module. 


Execution continues as described above 
for a larger system, except that SMCH 
(IGFVMCDO) schedules the record build 
module (IGFVMCE5) to be loaded instead of 
branching to it. When execution is com- 
plete, the 2K page is freed to allow its 
use ky the system. 


To accomplish this difference in loading 
transient modules, the following changes 
appear in system structure: 


°e In a system 2 192K: IGFVMCDO contains 
SMCH and acts as the transient area. 
IGFVMCE5 is contained in the nucleus 
and contains Error Record Build. 


e In a system < 192K: IGFVMCDO is used 
as SMCH and acts as the transient area 
on a 2K page. IGFVMCE5 is loaded some- 
where other than resident storage by 
IGFVMCDO. IGFVMCF6 is added as a pag- 
ing interface (owned by the Paging 
Supervisor). 


Figure MCH-10 illustrates the transient 
loading technique. 


MCH GENERAL PROCESSING 


Figures MCH-11 and MCH-12 illustrate the 
modules used in general processing of soft 
and hard errors. 
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MCH MODULE DESCRIPTIONS 


The following module descriptions summarize the functions of MCH that are done by each J 


of the MCH modules. Additional information concerning MCH modules can be found in the 
method of operation diagrams and in the prologues for each module. Prologues can be 
found on the microfiche for each module. 


e Switches mode of the processor from record to quiet when the threshold for soft 
errors has been reached. 


-~------------7------------------- y-~----------------------------------------—--------- { 

Entry Point | Entered From | Exits To | 
---------—-- -------------------}-----------------------------------------------------4 
| IGFVMCDO | IGFVMCEO | IGFVMCE5 to build the error record. | 
| | IGFVMCF4 | | 
beeetoceeu see. 5 elec a epee ees Pie Siew Se lee Soot eee ee a ia a ee ee ad 
mcg a hy Ba Cae ang ere ee Rg et tg Ne a eae eso ey 1 
| IGFVMCD1 - Hardware Error Analysis ( 
fo ee 
| ® Analyzes and gathers data about the malfunction causing the interruption. | 
| | 
| © Determines the severity of real storage failures. | 
| | 
| © Handles machine-check interruptions occurring as a result of storing and fetching | 
| from the damaged location. | 
| | 
j; * Determines the severity of the SPF key failure (all models). | 
| | 
| @ Handles machine-check interruptions resulting from key exercises. | 
| | 
FS a a eee ee 
| Entry Point | Entered From | Exits To | 
}------------- {-------------------}----------- #-~---~-------+--------------=------------ { 
| IGFVMCD1 | IGFVMCEO | IGFVMCF1 to continue MCH recovery procedures. [ 
| | | | 
| | | IGFVMCDO when the type of malfunction cannot be | 
| | | identified through the machine-check interruption | 
| | | code. | 
Doren 2s De et I aa te ee J 
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|] 


c 


Gag ey eo ee na Se eae a eg wr ga ge ee pea ae ay ed tT Pe gl ee ee Ps 1 
| IGFVMCEO - Machine-Check Handler Nucleus | 
Pte I EE EO EE EEE ___e 
| « Inhibits interruptions. | 
| | 
{| e Saves critical data. | 
| | 
| e Examines hardware-produced data for cause of interruption. | 
| | 
{| e Handles machine-check interruptions occurring while another machine-check interrup- | 
| tion is being processed. | 
| | 
[-------------y------------------- [----------------------------=------------------------ { 
| Entry Point | Entered From | Exits To | 
poa--—=--—— =~ to----------------—- }-----------~---—----------+---------~----------=----- 
| IGFVMCE0O | Machine-check {| IGFVMCDO when there is an HIR- or ECC-corrected | 
| {| interruption {| malfunction. | 
| | | | 
| | | IGFVMCD1 for instruction processing damage. | 
------------ $-------------------4 | 

{| IGFERRO | Machine-Check | The wait state: | 
{| (SHUT) {| interruption | { 
| | | | 
| | Channel-Check | when a hard machine-check interruption occurs | 
| { Handler | during the processing of a hard machine-check | 
| | | interruption and the original interruption has | 
| | | not yet been recovered from. | 
| | 
{ { { when system damage has occurred. | 
| | | | 
| | | when the I/O module (IGFVMCE4) is unable to load | 
| | | a transient module. | 
| | | | 
{ | | when entry was from the wait state interface. | 
| | | (DSS, Paging Supervisor, or CCH.) | 
--------—-- {-------------------}+---------------+-------------------------------—---—-4 

| IGFPOST1 | IGFVMCE5 | Dispatcher or interrupted program. | 
ee a ee ee ee ee 
a aa a a a aa a GL a aaa a 1 
| IGFVMCE1 - Console Write | 
Ce ee 
| e Issues messages to the system console through an SVC 35. | 
| 

ee ree a Pee fee ce ee Ae eat ea Ds rer a ar or ee ee ee Se ee ee ee ae eS { 

| Entry Point | Entered From | Exits To | 
~----=------- }-------------------}-----------------------------------------------------4 
| IGFVMCE1 | IGFVMCE2 {| Communications Task Router. | 
| (IGCR207B) | | | 
bee ee ee Be eee a eg a a ar ee yO PE ye a ae men J 
CSS ee ee ee ee ee ee ee eee ee ee ee ee ee 1 
| IGFVMCE2 - Error Recorder | 
Eee ee cs ek SCT 
| e Writes MCH error records into the SYS1.LOGREC data set. | 
| | 
a aaa aa SR | eg ey tae gees ar BM ee ae ge ee Gs a en ag ey a { 
{| Entry Point | Entered From | Exits To | 
}------------- 4-------------------}----------------------------------------------------- : 
| IGFVMCE2 {| System communica- | IGFVMCE1 (IGCR207B) to issue associated messages. | 
| (IGCR107B) | tions task router | | 
a re neat ee Sm ape ees ee Og re pe le A Py PE OPER Rone EO Ee OO a RO SE 
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Ce ge a ee te eee ae eee ae ae nS eee ee ee 1 
| IGFVMCE3 - Emergency Recorder | 
[eisai ian ian rail { 
| 
| « Writes CCH and MCH error records into the SYS1.LOGREC data set. | 
| | 
[-------------y------------------- {----------------------------------------------------- { 
| Entry Point | Entered From | Exits To | 
------------- t-------------------4----------------------------------------------------| 
| IGFVMCE3 | IGFVMCE4 | IGFERRO (SHUT routine) 
Be ee Ss Sea ar eee een re pene eer Ws ee Se eee ee at Se ee eee -J 
aaa a a a aR eR a a a a a aa wd 1 
| IGFVMCE4 - MCH I/O Control | 
a eee, 
| «© Loads transient MCH modules. | 
| | 
| « Handles I/O operations for the Emergency Recorder (IGFVMCE3). | 
| | 
Sr eee Oe ee oe a aa a a a a a TEL ea eg ee ee Se ee 1 
| Entry Point | Entered From | Exits To | 
}------------- {------------------- $o-2-- 22-2 ----~-- 2 - = 2 $= === === 2 { 
| NMODSCED | IGFVMCEO | Any of the following transient modules: | 
l | IGFVMCD1 | IGFVMCDO | 
| | IGFVMCF1 | IGFVMCD1 | 
| | IGFVMCF2 | IGFVMCF1 | 
| | IGFVMCF3 | IGFVMCF 2 | 
| | IGFVMCF4 | IGFVMCF3 | 
| | IGFVMCE3 | IGF VMCF4 | 
| | IGFVMCE5 | IGFVMCF5 | 
| | IGFVMCDO | IGFVMCE3 { 
|------------- {---=--------------- { | Le | 
| IGFLOAD | Module Scheduler | IGFVMCEO if the loading operation is not successful. | 
| | subroutine of [ | 
| | IGFVMCE4 | | 
(Sos eee = | en a eR | 
| IGFIORTN | IfO Initialization| | 
| | subroutine of | | 
| | IGFVMCE4 | | 
LS Se et at ee ee ee a ee ee pe ee ee ee a ee ad 
a a ga a ee ge te, ee Fee ne ae a a ee Rs a eg Oe 1 
| IGFVMCE5 - Error Record Build | 
}--------------------- ------- $= === $$ $= $= $$ $2 n nnn nnn nnn nn nnn nn nn nnn nn nnn nnn 
| 
| « Prepares error records to be recorded in SYS1.LOGREC. | 
| | 
{ « Posts the RMS ECB to permit the MCH Error Recorder to run under the communications | 
| task TCB. | 
| | 
| e« Terminates the resident operations of MCH. | 
| | 
[Sen ee - Mr a a ce ae eg a ey ee ee Se { 
| Entry Point | Entered From | Exits To | 
}------------- +------------------- }~-------------------+-------------------------------- { 
| IGFVMCE5 | IGFVMCEO | IGFVMCEO for returning control to the system. | 
| | | 
| | IGFVMCDO | IGFVMCE3 to put MCH record out if system cannot | 
| | | continue. | 
bo See acs See a i oe a ee ee ee J 
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c 


| 

| « Determines which portion of the operating system is associated with the 
| malfunction. 
| 
| 
| 


e Determines whether it is feasible to attempt to repair the damage to the software. 


SSS SSS 9 a a a a SS a Se 
| Entry Point | Entered From | Exits To | 
[------------- ------------------- }----------------------------------------------------- { 
| IGFVMCF1 | IGFVMCEO | IGFVMCF2 when it has been determined that software | 
| | | repair is possible. | 
| | IGFVMCD1 | IGFVMCF4 when software repair is either not { 
| | {| required or not possible. { 
bees e Seas Pesese See eee ee a eee J 
LO ee ee ee et ae nr ee ee ee ee Se ee ee 1 
| IGFVMCF2 - Damage Repair { 
ne as 
| © Determines repair actions that can be taken]/in respect to the type of error that { 
| occurred: repairing damaged SPF key, isolating damaged real storage locations so | 
| they cannot be reused, and forcing damaged pages into new locations in real storage | 
| so they can be reexecuted successfully. | 
| | 
RR E aE) a Sa Sa a aa ae { 

| Entry Point | Entered From [ Exits To 
}------------- +--------~---------- +----------------------------------------------------- { 
| IGFVMCF2 | IGFVMCF1 | IGFVMCF4 when repair has been successful. | 
l | IEAPTRV | | 
| | LEAPFP2 (VS2) | IGFVMCF3 when repair attempt has been unsuccessful | 
| | ILEAPRLS3 (VS2) | to allow the subsystem interface to attempt | 
| | RSTDQXOO (VS1) | xecovery. | 
| | IGCO7902 (VS2) | | 
| | | IEAPTRV to translate the real failing storage { 
| | | address to a virtual address. | 
| | | | 
| | | IEAPFP2 to find the PTE. | 
| | | 
| | | IEAPRLS3 to dequeue the page from the PFT (VS2). | 
| | | | 
| | | RSTDQX0O to dequeue the page from the PFT (VS1). | 
| | | | 
| | | IGC07902 to set the job step TCB (JSTCB) and all | 
| | | subtasks nondispatchable (VS2). | 
bee ee Des eo a ee be ea ee ee ee eee J 
SS a ee ee ee ee en Se ee ee 1 
{ IGFVMCF3 ~ Subsystem Interface | 
Fo es st ce os ee | 
| *© Determines whether the active subsystem contains recovery support. { 
| 
{| « Calls the recovery module of the subsystem. | 
| | 
| « Passes data to the subsystem to permit it to carry out its recovery activities. | 
| | 
See ee ea Nee ee ee ee Se ep eS { 

| Entry Point | Entered From | Exits To | 
------------ {-------------------}-----------------------------------------------------4 

| IGFVMCF3 | IGFVMCF2 | A subsystem recovery module. | 
| | Subsystem Recovery| | 
| | module | IGFVMCF4 after subsystem has attempted recovery. | 
beta See Sone ha ie re Bp SS ee ee ee ee J 
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SS Ya ha a a at eee ee = 
IGFVMCF4 - Terminator | 

a ea i rt ee et ee ee ee ee Se ee a eee 
e Schedules termination of tasks or operating system based on conclusions of pre- | 
viously executed modules. | 

| 

e Schedules appropriate message, either “task non-dispatchable" or “wait state" | 
message. | 

| 

ere ee ee a ep ee Ne ct gn tg gms ee oe pp ee ee ap { 
Entry Point | Entered From | Exits To | 
------------ {ann nnn enn nf nnn nn nn nn nnn nnn nnn nnn nnn nn nnn nnn 
IGFVMCF4 | IGFVMCF1 | IGFVMCDO to initiate error recording. | 
| IGFVMCF2 | | 

| IGFVMCF3 | | 

Soe esos ee an ee ee ee ee ee ee 
eee See a ee a a ee eee 
IGC2603D - MODE Conmand Module | 

i Se a ee ee ee eee | 
e Informs the operator of the status of the processor upon his request. | 
| 

e Switches the mode of the processor from record to quiet or quiet to record. | 
| 

ee Te ee ee ee nee oe een 
Entry Point | Entered From | Exits To | 
------------ }-------------------}----------------------------------------------------+4 
IGC2603D | IEEO4O3D (Command | Supervisor (SVC 3) | 
(IGFVMCD4 | Router) | | 
alias) | | IGC0O503D (for error messages). | 

See ee a eS ee ee eee ee a eee ee eh ee ee See eee 


The directory provides a quick reference 
from this publication to the pertinent cod- 


ing, or from the coding Lack into the pub- 


lication. 


lowing information: 


Module and CSECT Name: 
object module 
ing indicated 


Label: 
entry points, 
ing, and data 


.---------------- 
Module and 


CSECT Name 
} Sees Se See a 


ee OE lo OO ee on = ee 


IGC2603D 


(IGFVMCD4 


alias) 


IGFVMCEO 


Names 


The directory contains the fol- 
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DIRECTORY 


Library: The place where the module 
resides. 
Name: The descriptive name used to refer 


to the module. 


The name of the 


and CSECT containing the cod- 
by the label. 


taken from the listing for 


Diagram: 


The method of operation diagram 


containing information about the coding 


Significant sections of cod- 


areas. 


-——+ —— —— — — 4 —— — 4+ — — — YH + 


CKSYNTAX 
STATRIN 
MAINRTN 
RETRYRTN 


ANALYSIS 
IGFERRO 
IGFNO000 
MCICCK 
MCICVALD 
MSGWRITE 
NOCONSL 
SETCHMSG 
TESTIPD 
TSTTIME 
TSTTODC 
TESTSYSD 


BEGIN 
COMBUILD 
MOVEDA 
READY 
TEST1 
TEST2 


ACTCHECK 
IORTN 


b——+——— —— — 4+ — — — 4+ — — — 4 4 4 YH 4 


SYS1.SVCLIB 
SYS1.LPALIB 
(VS2) 


SYS1.SVCLIB ata 
SYS1.LINKLIB 
i 
Nucleus 


Nucleus 


SYS1.SVCLIB 
SYS1.LPALIB 
(VS2) 
SYS1.SVCLIB 
SYS1.LPALIB 
(VS2) 


-— — + — — — — — — 4+ — — — 4+ — — — +} 4} — 4 YH 4 


identified by the label. 


MCH Nucleus 


on = 2 ow 2 © 2 2 2 8 2 ee © 2 ee © oe 2 


Error Recorder 
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r 
| Module and 
| CSECT Name 


IGFVMCE5 


IGFVMCF1 
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BUFMGMT 
BUILDREC 
RECFRMT 


SYS1.LINKLIB 
(VS1) 

Nucleus 
(VS2) 


SYS1.LINKLIB)VS1 
SYS1.SVCLIB } 
a 
Nucleus 


SYS1.SVCLIB 


MCH 1/0 Control 


~---------------}--------------}------------------}---------------------------- 


System Analysis 


——4 


1 
1 
1 
1 
1 
1 
1 
al 


c 


Diagram| 


MCH SECTION 5: DATA AREAS 


This section contains descriptions of the principal data areas used by 
MCH: 


e Fixed storage areas 

e Machine-check interruption code 
e MCH independent common area 

e MCH recovery vector table 

e Machine status block 

e MCH long record 

e MCH testing vector table 


The symbolic names shown in individual fields represent the displace- 
ment, in bytes, from the beginning of a specific data area to the field. 
Access is gained to a specific field by using an instruction in which the 
beginning address of the area (usually contained in a register) is the 
base address, and the symbolic field name represents the displacement. 
Use of the fields can be traced in the MCH listings ry first locating the 
Symbolic field names in the cross-reference table at the back of the 
listings and then noting where the names are used. 


The field headings, used for other than the fixed areas, and their mean- 
ings are: 


Displacement: The numeric address of the field relative to the beginning 
of the data area. The first number is in decimal; the second (in paren- 
theses) is the hexadecimal equivalent. 


Bytes and Bit Patterns: The size (number of bytes) of the field and the 
bit settings of flag fields; that is, the state of bits ina byte. When 
the column is used to show the state of bits, it is shown as follows: 


ecee eoee The 8 bit positions (0-7) ina byte. For ease of scanning, 
the high-order (left-hand) four bits are separated from the 
low-order four bits. 

1... .... A reference to bit 0. 

ecee «e-XX BitS 6 and 7 are reserved. 


Bit settings that are significant are shown and described. Bit settings 
that are not presently significant are described as reserved bits. 


Field Name: A name that identifies the field. 
Field Description: The use of the field. 
Figure MCH-13 is provided to assist in locating MCH fields. This 


figure contains an alphabetic list of the fields with their 
displacements. 
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Sit es, o Mee es SP en a We er ge 5 eta ew Gt ey ee ae mete eet ee Sete tere Mg ee a ty NA pare pe gp ee ae ee ty SP ee qe 
| Field |Displacement|| Field |Displacement]| Field |Displacement|| Field |Displacement | 
fHeares--—— [a esr fp oSSsse—S-= , a a eae i Ca a ae ea: | lias a RRS CN il COE LEDER a aa cae { 
| MCKETLO* | 328 (148)|| MCHINTEL | 104 (68) || MCHSKADR | 604 (25C)|| RVTINLOG | 32 (20) | 
| MCKFXLO*# | 48 (30) || MCHINTLO | 104 (68) || MCHSPARE | 2 (2) |] RVTIOREG | 112 (70) | 
| MCKPSW* | 40 (28) || MCHINTL1 | 105 (69) || MCHSPR1 | 93 (5D) || RVTIOSEP | 56 (38) | 
| MCHABREC | 619 (26B) || MCHIOB | 332 (146) || MCHSPR2 | 370 (174) || RVTIOSIH | 60 (3c) | 
| MCHABRNO | 618 (26A)|| MCHIOBSK | 362 (16C)|| MCHSRCH | 536 (218)|| RVTIOSNS | 80 (50) | 
| MCHBYREM | 514 (202)]| MCHIODCB | 352 (160)|| MCHSTATD*| (end of long|| RVTLEVEL | 100 (64) | 
| MCHCCHAD | 612 (264)|| MCHIOECB | 336 (150) [| | record) || RVTLOADA | 28 (1c) | 
| MCHCCHLN | 616 (268)|| MCHIPTR | 402 (194)|] MCHSUBA | 316 (13C)|| RVTLNG | 102 (68) | 
| MCHCCW | 544 (220)|| MCHLEVEL | 320 (140)]| MCHSUBAW | 88 (58) || | or 140 (8c) | 
| MCHCCWRD | 390 (188) || MCHLOGCO | 108 (6c) || MCHTCBAF | 80 (50) || RVTMSB | 64 (40) | 
| MCHCCWSR | 374 (178)|] MCHLOGC1 | 109 (6D) || MCHTCBCU | 76 (4C) || RVINIPRM | 24 (18) | 
| MCHCCWIC | 382 (180)|| MCHLOGC2 | 110 (6E) || MCHTFLAG | 611 (263)|[| RVINUCAD | 0 (0) | 
| MCHCLRLN | 94 (5E) || MCHLOGIC | 108 (6c) || MCHTIC | 544 (220)|| RVTPAGES | 84 (54) | 
| MCHDALEN | 0 (0) || MCHLONG | 492 (1EC) || MCHTKPCY | 525 (20D) || RVTPDISW | 124 (7c) | 
| MCHDAMAG | 8 (8) || MCHLSTTR | 518 (206)|| MCHTMSVE | 112 (70) || RVIPGESW | 120 (78) | 
| MCHDEVCD | 529 (211)[| MCHLWLIM | 498 (1F2)|| MCHTRCAP | 516 (204)|| RVTPOST1 | 8 (8) | 
| MCHDMGO | 8 (8) || MCHMAINT | 835 (343)|| MCHTTRIN | 324 (144)|| RVTPRIMY | 48 (30) | 
| MCHDMG1 | 9 (9) || MCHMCSRT | 612 (264) |} MCHUCB | 328 (148)|| RVTRESUM | 108 (6c) | 
| MCHDMG2 | 10 (A) || MCHMLSAV | 252 (FC) || MCHUPLIM | 502 (1F6)|| RVTSBSYS | 96 (60) | 
| MCHDMG3_ | 11 (B) |] MCHNXHIS | 111 (6F) || MCHWORK | 496 (1F0)|| RVTSECND | 52 (34) | 
| MCHDMG4 | 12 (Cc) [| MCHNXMOD | 92 (5c) || MCHWRNCT | 527 (20F)|| RVTSHUT | 44y (2c) | 
| MCHDMG5 = | 13 (D) || MCHPDAR | 56 (38) || MCHWRNSW | 534 (216)|| RVTSIRBA | 68 (44) | 
| MCHDMG6 | 14 (E) || MCHPDARI | 76 (48) || MCHWRNTR | 530 (212)|| RVTSIRBE | 128 (80) | 
| MCHDMG7_ | 15 (F) || MCHPDARO | 56 (38) || MSBBUFER | 16 (10) || RVTSIRFOQ | 136 (88) | 
| MCHERR | 400 (192)|| MCHPDAR1 | 57 (39) || MSBBUFTH | 20 (14) || RVTSMCH | 4 (4) | 
| MCHEXCCW | 576 (240) || MCHPDAR2 | 58 (3A) || MSBCOUNT | 8 (8) || RVTSVF | 116 (74) | 
| MCHEXCSW | 568 (238)|| MCHPDAR3 | 59 (3B) || MSBCPUID | 0 (O) || RVTTP1EX | 132 (84) | 
| MCHEXDCB | 580 (244) || MCHPDAR4 | 60 (3c) || MSBBUFD1 | 44 (2C) || RVTTRANS | 24 (18) | 
| MCHEXECB | 600 (258)|| MCHPDARS | 61 (3D) || MSBBUFD2 | 56 (38) || RVTTRS | 40 (28) | 
| MCHEXEPT | 564 (234)|| MCHPDAR6 | 62 (3E) || MSBBUFE1 | 40 (28) || RVTVCOMM | 12 (Cc) | 
| MCHEXIOB | 560 (230)|| MCHPDAR7 | 63 (3F) || MSBBUFE2 | 48 (30) || RVTWSFLG | 88 (58) | 
| MCHEXLEV | 55 (37) || MCHPGESW | 92 (5c) || MSBECCDS | 36 (24) || RVTWSFLO | 88 (58) | 
| MCHEXSEK | 592 (250) || MCHPGWPC | 124 (7c) || MSBECCD2 | 72 (48) || RVTWSFL1 | 89 (59) | 
| MCHFCTL | 398 (190)|] MCHPSA | 124 (7c) || MSBECCEN | 32 (20) || RVIWSFL2 | 90 (5A) | 
| MCHFSAR | 16 (10) || MCHPSWAD | 100 (64) || MSBECCE2 | 64 (40) || RVIWSFL3 | 91 (5B) | 
| MCHFSAV | 64 (40) || MCHPSWCP | 98 (62) || MSBLEVEL | 80 (50) || RVTIWSMSG | 16 (10) | 
| MCHFSEAV | 68 (44) || MCHPSWM | 96 (60) || MSBLNG_ | 92 (SC) [|| TVTLEVEL | 28 (1C) | 
| MCHFSTBY | 535 (217) || MCHPSWSP | 99 (63) || MSBLOGSZ | 6 (6) || TVTMCN | 8 (8) | 
| MCHHDREC | 496 (1F0)|| MCHPSWWM | 97 (61) || MSBMODE | 24 (18) || TVTPCN | 4 (4) | 
| MCHHISTY | 24 (18) || MCHRCTL | 399 (191)|]| MSBMODEL | 4 (4) || TVTRPSW | 24 (18) | 
| MCHIBLNG | 408 (19A)|| MCHRECST | 507 (1FB)|| MSBMODE1 | 24 (18) || TVTRIN | 16 (10) | 
| MCHIBTXT | 410 (19C) [|| MCHRELNO | 106 (6A) || MSBSERNO | 1 (1) |[ TvTsiIm | 0 (Oo) | 
| MCHIBUF | 406 (198)|| MCHRES | 401 (193)/| MSBSPARE | 84 (54) || TVTSOLID | 0 (0) | 
| MCHIBWSC | 406 (198)|| MCHRPSW | 96 (60) || MSBTHRLD | 12 (C) || TVTSPARE | 29 (1D) | 
| MCHICBSP | 356 (164)|| MCHSBSF1 | 85 (55) || RVTBUILD | 36 (24) || TVITEST | 0 (0) | 
| MCHICCWS | 344 (158) || MCHSBSF2 | 86 (56) || RVTBUFAD | 92 (5C) || TVTWAIT | 12 (c) | 
| MCHIOCSW | 340 (154)|| MCHSBSF3 | 87 (57) || RVTCCHRC | 20 (14) || TvTWPSW | 20 (14) | 
{| MCHINT | 398 (190)|| MCHSBSID | 84 (54) || | i | { | 
t a a a a ae oe oO eee , ee Se Loo Soe a 2 { 
| Note: Field names with an * are in the MCH Long Record. Otherwise, all field names beginning | 
| with MCH are in the MCH Independent Common Area, all field names beginning with MSB are in the | 
| Machine Status Block, all field names beginning with RVT are in the Recovery Vector Table, and | 
| all field names beginning with TVT are in the Testing Vector Table. | 
bene ee ae oe ee a ee ee ee ee a eee ee ee eee Se eS ee ee ee ee ee eee ee J 


Figure MCH-13. 
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0 


Locations of MCH fields 


FIXED STORAGE AREAS USED BY MCH 


C 


Location 


138 
140 
141 
142 
144 
145 
148 
149 
150 
153 


157 
160 
168 
172 
176 
180 
184 
188 
232 
240 
248 
252 
256 
352 
384 
HU8 
512 


(0) 
(8) 
(10) 
(18) 
(20) 
(28) 
(30) 
(38) 
(40) 
(48) 
(4c) 
(50) 
(54) 
(58) 
(60) 
(68) 
(70) 
(78) 
(80) 
(85) 
(86) 
(88) 
(89) 
(8A) 
(8C) 
(8D) 
(8E) 
(90) 
(91) 
(94) 
(95) 
(96) 
(99) 
(9C) 
(9D) 
(A0) 
(A8) 
(AC) 
(BO) 
(B4) 
(B8) 
(BC) 
(E8) 
(FO) 
(F8) 
(FC) 
(100) 
(160) 
(180) 
(1¢C0) 
(200) 


Length in 


Bytes 
8 


PHromOrrFFrFF FF OWHPWWRPRPWRNHORP PPO RFPRPNHP UDO OWMWOmWFFrF SE wOOmanmnnwmwewe 


96 
32 
64 
64 
Variable 


Field Description 
IPL PSW 


IPL ccw 1 

IPL CCW 2. 

External old PSW. 

SVC old PSW. 

Program-check old PSW. 
Machine-check old PSW. 

I/O old PSW. 

Channel status word 

Channel address word 

Reserved. 

Interval timer. 

Reserved. 

External new PSW. 

sVC new PSW. 

Program-check new PSW. 
Machine-check new PSW. 

I/O new PSW. 

Reserved. 

External ILC. 

External interrupt code. 
Reserved. 

Svc ILc. 

SVC interrupt code. 

Reserved. 

Program-check IIc. 
Program-check interrupt code. 
Reserved. 

Translation exception address. 
Monitor class number. 

PER (Program Event Recording) code. 
Reserved. 

PER (Program Event Recording) address. 
Reserved. 

Monitor code. 

Reserved. 

Channel ID. 

I/O extended logout pointer. 
Limited channel logout (ECSW). 
Reserved. 

I/O address. 

Reserved. 

Machine-~-check interrupt code. 
Reserved. 

Failing storage address. 
Region code. 

Reserved. 

Floating-point register save area. 
General purpose register save area. 
Control register save area. 
CPU extended logout area. 
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42 


MACHINE-CHECK INTERRUPTION CODE 


The machine-check interruption code is two full words long (64 bits), 
and it includes information about the type and severity of the error, the 
validity of the various fields that are stored, and the validity and 
length of the extended logout. 


Bit 
0 (SD) 


8 


9- 


14 


15 


16 


17 


18 


(PD) 


(SR) 


(TD) 


(CD) 


(ED) 


(DG) 


(Ww) 


13 


(B) 


(D) 


(SE) 


(SC) 


(KE) 


Meaning 
System Damage: Set whenever interruptions may have been lost 


or damage has occurred that cannot te isolated to one or more 
of the less severe machine-check damage types, either internal 
or external. 


Instruction Processing Damage: Set when the extent of the 
damage is limited to an executed instruction or its associated 
operands. 


System Recovery: Errors were detected but have been success- 
fully recovered without loss of system integrity. 


Timer Damage: Damage has occurred to either the timer or to 
location 80. 


Time-of-Day Clock Damage: Damage has occurred to the time-of- 
day clock. 


External Damage: A channel, channel controller, switching 
unit or other unit external to the CPU or to a storage unit 
has been damaged during operations not directly associated 
with the CPU. ED is used to report damage of this type only 
when the more conventional reporting procedures, such as I/O 
interruption, are unavailable or are impractical. 


Reserved. 


Degradation: Continuous degradation of system performance, 
more serious than normal system recovery has occurred. Degra- 
dation may be reported when system recovery conditions exceed 
a hardware pre-established threshold or when unit deletion has 
occurred. 


Warning: Damage is impending to some part of the system; for 
example, loss of power or loss of cooling. 


Reserved. 


Backup: The machine state at the point of interruption has 
been restored to a hardware checkpoint state prior to the 
occurrence of error; that is, the PSW, registers, and storage 
reflect a valid state either at the beginning of the instruc- 
tion in error or some prior instruction. If the backup bit is 
0, a valid instruction address points to an instruction beyond 
the error. 


Delayed: Some or all of the information stored as a result of 
this interruption was delayed in being reported because the 
interruption type was masked off for the duration of one or 
more instructions. 


Storage Error Uncorrected: A reference to storage resulted in 
the detection of damaged data that could not he corrected. 


Storage Error Corrected: A reference to storage resulted in 
the detection of an error that was subsequently corrected. 


Key in Storage Error Uncorrected: A key in storage contains 
invalid CBC. 


C 


Bit 
19 


20 (WP) 


21 (MS) 


22 (PM) 


23 (IA) 


24 (FA) 


25 (RC) 


26 


27 (FP) 


28 (GR) 


29 (CR) 


30 (LG) 


31 (ST) 


32-45 


46 (CT) 


47 (CC) 


48-63 


Meaning 
Reserved. 


PSW Validity: Bits 12-15 of the machine-check old PSW are 
valid. 


PSW Masks and Key Validity: All PSW bits other than interrup- 
tion code, ILC, AMWP, IA, CC, and program mask of the machine- 
check old PSW are valid. 


Program Mask and Condition Code Validity: The program mask 
and condition code in the machine-check old PSW are valid. 


Instruction Address Validity: The instruction address in the 
machine-check old PSW accurately reflects the point in the 
instruction sequence at which the interruption occurred. Note 
that the instruction location at interruption and the instruc- 
tion location at the time of the error may not be the same. 

If backup has been indicated, a valid instruction address will 
point to the instruction in error or prior to the error. If 
backup is not indicated, a valid instruction address will 
point to an instruction following the error. 


Failing-Storage Address Valid: The failing-storage address in 
the failing save area is valid. 


Region Code Valid: A valid region code has been stored. 
Reserved. 


Floating-Point Registers Valid: the contents stored in the 
floating-point register save area are the same as the contents 
of the registers at the point of interruption. 


General Registers Valid: The contents stored in the general 
register save area are the same as the contents of the regis- 
ters at the point of interruption. 


Control Register Validity: The contents stored in the control 
register save area accurately reflect the condition of the 
control registers at the time of interruption. 


Log Valid: The CPU extended log information was correctly 
stored. 


Storage Logical Validity: The contents of those storage loca- 
tions that are modified by execution were restored to their 
contents at the point of interruption. 


Reserved. 


CPU Timer Valid: The CPU timer iS not in error and the con- 
tents stored in the CPU timer save area (location 216) reflect 
the correct state of the CPU timer at the time the interrup- 
tion occurred. 


Clock Compartor Valid: The clock comparator is not in error 
and the contents stored in the clock comparator save area 
(location 224) reflect the correct state of the clock 
comparator. 


CPU Extended Log Length: This field indicates the length in 
bytes of the information stored in the extended log area, 
Starting at the location specified by the CPU extended log 
pointer in control register 15. On a machine-~check interrup- 
tion when no logout occurs, this field is set to 0. 
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MCH INDEPENDENT COMMON AREA 


The MCH independent common area occupies 1,024 bytes in the MCH resi- 
It is used by the MCH modules to communicate with each other 
and to store data to be included in the error records that are written 


dent area. 


into the SYS1.LOGREC data set. 


Displacement 


MON © 


10 
11 


12 


13 


14 
15 
16 


20 
24 


54 


55 


56 


(0) 
(2) 
(8) 
(8) 


(9) 


(A) 
(B) 


(Cc) 


(D) 


(E) 
(F) 
(10) 


(14) 
(18) 


(36) 


(37) 


(38) 


Bytes and 


Bit Patterns 
2 


1... 
o1.. 
eel. 
eoel 


1... 
1... 
eel. 
coed 


De eee 
wk etss 
ee Ae 


oe oX 


1... 
e1.. 
eel. 
eeeol 


e1.. 
ea Ue 


eoel 
Xeon 


6 
8 
1 


1... 
el.. 
ee XX 
1 


1... 
-1.. 
eel. 
eoel 


Py Derem 
X.XX 


XXXX 


Field Name 


MC HDALEN 
MCHS PARE 
MC HDAMAG 
MC HDMGO 


MCHDMG1 


MCHDMG 2 
MCHDMG3 


MCHDMG4 


MCHDMG5 


MC HDMG6 
MCHDMG7 
MCHFSAR 


MCHHISTY 


MCHNXHIS 


MCHEXLEV 


MCHPDAR 


Field Description 
Length of damage assessment field. 


Reserved. 

Damage assessment data. 
System status: 

Hardware recovery. 

Software recovery. 

Task aborted. 

Task nondispatchable. 
Operating system termination. 
Quiet mode in effect. 
Reserved. 

Damage area: 

Real storage. 

Buffer. 

Control storage. 

Interval timer. 

Processor. 

Channel error. 

Time-of-day clock. 

System damage. 

Reserved. 

Error type: 

Intermittent. 

Solid. 

Data. 

Protect. 

Reserved. 

RMS action data: 

Loop time out. 

Repair. 

Storage reconfigure. 

Buffer reconfigure. 

Reserved. 

RMS information status: 
Invalid machine-check inter- 
rupt code. 

Invalid failing storage 
address. 

Program check in MCH. 
Reserved. 

Reserved. 

Reserved. 

Real address location of the 
failure. 

Reserved. 

Table of which MCH modules 
have executed and in what 
sequence. 

First byte following the MCH 
history table, containing the 
ID of the module last loaded. 
Second byte following the MCH 
history table, containing the 
change level of the last 
loaded module. 

Program damage assessment and 
repair data. 


Displacement 
56 


58 


59 


60 
61 


62 


63 


C i 


(38) 


(39) 


(3A) 


(3B) 


(3c) 
(3D) 


(3E) 


(3F) 


(40) 


Bytes and 


i esa 
Pai res 
Pere! 


Pe a 


y eee 
ad ere 


eake 
Per & 


1... 
o1.. 
eel. 
cool 


1... 
el... 
eel. 
ecel 


Disa 
o1.. 
eel. 
cool 


Te ate 


oy eee 
ere 
Paes I 


1... 
-1.. 
ool. 
eeel 


Bit Patterns 


1 


Lats 
° XXX 


XXXX 


Lar 
Pad eer 
2. XX 


1... 
el... 
eel. 
eeel 


Dice es 3 
Pe eae 
ee XX 


1... 
el1.. 
eel. 
eoel 


1... 
e1.. 
eel. 
cool 


Field Name 


MCHPDARO 


MCHPDAR1 


MCHPDAR2 


MCHPDAR3 


MC HPDAR4 
MCHPDARS5S 


MC HPDAR6 


MCHPDAR7 


MCHFSAV 


Field Description 
PDAR action: 


Termination of current task. 
Retry possible. 

Bypass (affected task) 
terminator. 

Repair unsuccessful. 
Indeterminate instruction 
counter. 

Reserved. 

Failure type: 

Solid storage data error. 
Intermittent storage data 
error. 

Solid SPF key error. 
Intermittent SPF key error. 
Reserved. 

Task in control when error 
occurred: 

Wait pseudo task. 

Paging supervisor task. 
Master scheduler task. 
System task. 

Proklem program task. 
Current PSW disabled for I/O. 
Reserved. 

Location of failure: 
Nucleus. 

SQA area. 

LSQA area. 

PQA (VS1 Only). 

Pageable area. 

Fixed page area. 

V=R address area. 

Critical area. 

Reserved. 

Requested operator awareness 
message: 

Supervisor damage. 

Task abnormal termination. 
Damaged page now unavailable. 
Damaged page now deleted. 
Task nondispatchable. 
Software recovery. 

Reserved. 

Footprints: 

Change bit on in storage pro- 
tect key of the affected page. 
Key in external page table. 
Page recursion. 

Page fix active on low end. 
Translate error. 

No page exists. 

Relocate off. 

Low end interface active. 
Footprints - interfaces: 
ABTERM interface. 

Translate interface. 

Find page interface. 

Page dequeue interface. 

Page enqueue interface. 
Status function interface. 
V=R release interface active. 
Post interface active. 
Beginning failing location's 
virtual address. 
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Displacement 


68 
72 


76 
80 


84 
85 


86 


87 


88 


89 
92 


93 
92 


96 


97 


98 


99 
100 


104 


(44) 
(48) 


C4C) 
(50) 


(54) 
(55) 


(56) 


(57) 


(58) 


(59) 
(5¢C) 


(5D) 
(5E) 


(60) 
(60) 


(61) 


(62) 


(63) 
(64) 


(68) 


Bytes and 


Bit Patterns 


4 


4 


‘a e@oeee 


Paes oes e#eese 


oXeX KXXX 


dee es eoee#s 


oXXX XXXX 


1 ee @ee#es 


Pe aera e@e#e 
eis e@eoeees 
eeeX XXXX 


0 ieee @ee#e 


XXX XXXX 


al eae e@ee#*s 


e@#es8@8 oa ae 
@®ees rea lee 


eoee#se ee i 


MeXK Keee 


@eeess Pa rome 


@ees Paras ie 


@eese Panes b 


XXXX Kee 


Field Narre 


MCHFSEAV 
MCHPDARI 


MCHTCBCU 
MCHTCBAF 


MCHSBSID 
MCHSBSF1 


MCHSBSF2 


MCHSBSF3 


MCHSUBAW 


MCHPGESW 


MCHSPR1 
MCHCLRLN 


MCHRPSW 
MCHPSWM 


MCHPSWWM 


MCHPSWCP 


MCHPSWSP 
MC HPSWAD 


MCHINTEL 


Field Description 

Ending failing location's vir- 
tual address. 

Instruction address at 
failure. 

TCB pointer of interrupted task. 
Pointer to TCB of the affected 
task. 

ID of subsystem (TSO=Hex '91'). 
Flags used by the subsystem: 
Subsystem module was in con- 
trol at the time of the 
interruption. 

Subsystem ID flag. 

Reserved. 

Flags used by the subsystem: 

A solid storage failure exists. 
Reserved. 

Flags used by the subsystem: 
No action required by MCH. 
Subsystem has handled current 
task. 

Subsystem has handled the 
affected task. 

Reserved. 


TSO flag. 

Reserved. 

Reserved. 

Contains switches for paging 
supervisor: 


1111 0000 Set page not 
available. 


0000 1111 Key failure. 
0000 0000 Set page invalid. 


1111 1111 Translation needed. 
Reserved. 

Length cleared by IGFVMCEO 
upon initial entry (MCH FLIH). 
Machine-check resume PSW. 

PSW masks: 

(PER) program event recording 
mask. 

Translate mask. 

I/O mask. 

External interruption mask. 
Reserved. 


Machine-check interruption 
enakled. 

Wait mask. 

Proklem program state. 
Reserved. 

Condition code and program 
mask. 

Segment protection. 

Address field (second word of 
PSW). 

Field of indicators used by 
SHUT routine in the MCH 
Nucleus. 


Displacement 


104 


109 
110 
111 


112 
124 
252 
316 


320 
324 


328 
332 
340 
344 
352 
356 
362 
370 
382 
390 
398 


398 


399 


(68) 


(69) 


(6A) 
(6B) 
(6C) 
(6C) 


(6D) 
(6E) 
(6F) 


(70) 
(7C) 
(FC) 


(13C) 


(140) 
(144) 


(148) 


(14c) 
(150) 
(154) 
(158) 
(160) 
(164) 
(16C) 


(174) 
(178) 
(180) 
(188) 
(190) 


(190) 


(191) 


Byte 


ese 
Pana 


Peres | 


oXes 


Pern 


XXX e 


1 


11.. 
1... 
el1.. 
eel. 
02 eX 


‘Ls ee 
ro Lae e 
e «XX 


S and 


Bit Patterns 


1 


ro eer 
Parad ie 


12 
28 
64 


ere 


- 


CmMFEMOELE 


women o 


= 


XXXX 


XXXX 


Field Name 


MCHINTLO 


MCHINTL1 


MCHRELNO 
MCHTMEVL 
MCHLOGIC 
MCHLOGC 0 


MCHLOGC1 
MC HLOGC 2 
MCHNXMOD 


MCHTMSVE 
MCHPSA 
MCHMLSAV 


MCHSUBA 


MCHLEVEL 
MCHTTRIN 


MCHUCB 


MCHIOB 

MCHIOECB 
MCHIOCSW 
MCHICCWS 
MCHIODCB 
MCHICBSP 
MC HIOBSK 


MCHS PR2 
MCHCCWSR 
MCHCCWTC 
MCHCCWRD 
MCHINT 


MCHFCTL 


MCHRCTL 


Field Description 


Multiple machine-check 
recursion. 

Put system down with scheduled 
message. 

Error record written 
successfully. 

I/O interface active. 
System damage detected. 
Reserved. 

Reserved for SHUT routine 
information. 

Release number. 

Time value for I/O Loop. 


Model 135 indicator. 

Model 145 indicator. 

Model 15511I/158 indicator. 
Model 165I11/168 indicator. 
Unknown processor model code. 
Reserved. 

Reserved. 


Index value for TTR of next 
module to be loaded into tran- 
Sient area. IGFRVT-RVTTRS 
contains pointers to TTRS. 
Save area for timing. 
Permanent storage assignment. 
Register save area for 
transient 

modules. 

Subsystems running under the 
operating system. 

Level of macro source. 

Input TTR of specified tran- 
sient module. 

Address of UCB for I/O 
operations. 

First byte flags of I/O block. 
Pointer to RMSECB. 

Last seven bytes = CSW. 
Pointer to channel progran. 
Address of DCB. 

Unused field in IOB. 

SEEK field (equal to MBBCCHHR 
of module to be loaded). 
Spare. 

Search CCW. 

TIC CCW. 

Read CCW. 

Fields used by Error Recorder 
and Console Write routines. 
Functional control byte. 


Invoke Error Recorder. 

Invoke Console Write routine. 
Emergency Recorder is running. 
Reserved. 

Record control byte. 

CCH record to be written. 

No room for long record. 
Reserved. 
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Bytes and 


Displacement Bit Patterns Field Name Field Description 


48 


400 (192) 1 MCHERR Error control byte. 

a ee ee LOGREC FULL message needed. 
eles? Sanaa I/O error message needed. 
eels coae Format error message needed. 
Bee! ar eeere MCHIBUF overlaid. 

ee ee eee LOGREC NEARLY FULL message. 
eaee XXX Reserved. 

401 (193) 1 MCHRES Reserved. 

402 (194) 4 MCHIPTR Pointer to message buffer. 

406 (198) 84 MCHIBUF MCH message buffer. 

406 (198) 2 MCHIBWSC Wait state code - first byte 
of MCHIBUF. Use of MCHIBUF 
for wait state messages only. 

408 (19A) 2 MCHIBLNG Length of text. 

410 (19¢C) 80 MCHIBTXT Text of message. 

492 (1EC) 4 MCHLONG Pointer to long record. 

496 (1F0) 122 MC HWORK Work area for error recording 
modules. 

496 (1F0) 2 MCHHDREC First field of MCHWORK used as 
identifier of LOGREC header. 

498 (1F2) 4 MCHLWLIM Starting CCHH of the extent of 
LOGREC. 

502 (1F6) 4 MCHUPLIM Ending CCHH of the extent of 
LOGREC. 

506 (1FA) 1 Reserved. 

507 (1FB) 7 MCHRECST BBCCHHR of start of recording 
area. 

514 (202) 2 MCHBYREM Number of bytes remaining on 
track. 

516 (204) 2 MCHTRCAP Number of bytes which can be 
written. 

518 (206) 7 MCHLSTTR BBCCHHR of last record written 
on a track. 

525 (20D) 2 MCHTKPCY Tracks per cylinder. 

527 (20F) 2 MCHWRNCT Number of bytes remaining on 
early warning message track 
when LOGREC is 90% full. 

529 (211) 1 MCHDEVCD Device type code. 

530 (212) 4 MCHWRNTR CCHH of track representing 
LOGREC 90% FULL. 

534 (216) 1 MCHWRNSW 

Lteieee. Secor LOGREC 90% FULL message issued. 
~XXX XXXX Reserved. 

535 (217) 1 MCHFSTBY Valid LOGREC header record. 

536 (218) 8 MCHSRCH CCW used for searches. 

544 (220) 8 MCHTIC CCW used to continue searches. 

552 (228) 8 MCHCCW CCW for READ or WRITE. 

560 (230) 4 MCHEXIOB IOB used ky Error Recorder. 

564 (234) 4 MCHEXEPT Pointer to ECB. 

568 (238) 8 MCHEXCSW CSw field. 

576 (240) 4 MC HEXCCW Pointer to CCW. 

580 (244) 4 MCHEXDCB Pointer to DCB. 

584 (248) 8 Reserved. 

592 (250) 8 MCHEXS EK MBBCCHHR for SEEK command 

600 (258) 4 MCHEXECB ECB for Error Recorder. 

604 (25C) 7 MCHSKADR BBCCHHR for SEEK. 

611 (263) 1 MC HTFLAG Switch for EOF WRITE. 

612 (264) 4 MCHMCSRT Return address for MCS 
systems. 

612 (264) 4 MCHCCHAD Address of CCH record. 

616 (268) 2 MCHCCHLN Length of CCH record. 

618 (26A) 1 MCHABRNO Number of ABREC buffers. 

619 (26B) 216 MC HABREC Abbreviated record buffer. 

835 (343) 53 MCHMAINT Reserved. 


MCH RECOVERY VECTOR TABLE 


The RVT (recovery vector table) is an MCH data area containing 
addresses and flags used during MCH processing. The address of the RVT 
is in the CVT (communications vector table) at the symbolic location 
CVTRMS. 


Bytes and 


Bit Patterns Field Name 


Dis placement Field Description 


on a =) 


20 
24 


24 
28 
32 


36 


40 


44 


48 


52 


56 


89 


(0) 
(4) 
(8) 
(C) 
(10) 
(14) 
(18) 


(18) 
(1C) 
(20) 


(24) 


(28) 


(2C) 


(30) 


(34) 


(38) 
(3C) 
(40) 
(44) 
(48) 


(50) 
(54) 


(58) 
(58) 


(59) 


eee 
Pp lena 
o XX 


hace: 
a are 
os ie 


eer2X 


SF f&ef EE 


See 


FFOoOF -F 


ae 


XXXX 


XXXX 


RVTNUCAD 
RVTSMCH 

RVTPOST1 
RVTVCOMM 
RVTWSMSG 
RVTCCHRC 
RVTNIPRM 


RVTTRANS 
RVTLOADA 
RVTINLOG 


RVTBUILD 


RVTTTRS 


RVTSHUT 


RVTPRIMY 


RVTSECND 


RVTIOSEP 
RVTIOSIH 
RVTMSB 

RVTSIRBA 
RVTIOSNS 
RVTPAGES 


RVTWSF LG 
RVTWSFLO 


RVTWSFL1 


Pointer to MCH Nucleus. 
Pointer to Soft MCH. 

Pointer to MCH Post routine. 
Pointer to MCH common area. 
Pointer to MCH Nucleus wait 
State entry. 

Pointer to CCH inboard record. 
Fields passed to NIP for sys- 
tems with less than 192K 
bytes. 

Pointer to MCH transient area. 
Pointer to Module Loader. 
Pointer to model-dependent 
logout area. RVTINLOG is 
initialized by NIP. 

Pointer to record buffer build 
area. This field is initia- 
lized by NIP. 

Pointer to MCH TTR table. 

This field is initialized by 
NIP. 

Pointer to MCH SHUT routine in 
MCH Nucleus. 

Pointer to primary logout 
area. This field is initia- 
lized by NIP. 

Pointer to secondary logout 
area. This field is initia- 
lized by NIP and used only for 
the Model 165II and 168. 
Pointer to IOS entry point for 
MCH/IOS interface. 

Pointer to IOS First-Level 
Interrupt Handler. 

Pointer to machine status 
block (MSB). 

Address of SIRB. 

Reserved. 

Pointer to IOS nest switch. 
Address of low end system 
(less than 192K) page-in 
module. 

Wait state interface flags. 
First byte of RVIWSFLG - CCH 
wait state interface flag: 
Machine-check in CCH. 
Unrecoverable channel error. 
Reserved. 

System wait state interface 
flag. 

Paging supervisor request. 
Dynamic support system request 
with no message. 

Dynamic support system request 
with message. 

Reserved. 
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Vsl 
only 


Displacement 


90 


91 
92 


96 
100 
104 
108 


108 
112 


116 
120 
124 
128 
132 
136 
140 


(5A) 


(5B) 


(5C) 


(60) 
(64) 
(68) 
(6C) 


(6C) 
(70) 


(74) 
(78) 
(7C) 
(80) 
(84) 
(88) 
(8C) 


Bytes and 


Bit Patterns 


1 


eee @aeee 


eXXX XXXX 


1 


& eee 


oa 


&eSeereet se 


Field Name 


RVTWSFL2 


RVTWSFL3 
RVTBUFAD 


RVTSBSYS 
RVTTVT 
RVTLEVEL 
RVTLNG 


RVTRESUM 
RVTIOREG 


RVTSVF 

RVTPGESW 
RVTPDISW 
RVTSIRBE 
RVTTP1EX 
RVTSIRFQ 
RVTLNG 


Field Description 
MCH wait state interface flag. 


MCH in process. 

Reserved. 

Reserved wait state interface 
flag. 

Pointer to wait state message 
buffer. 

Subsystem interface flags. 
Address of test vector table. 
Latest level of source macro. 
Length of RVT. 


Address of resume PSW. 
Address of I/O FLIH register 
Save area. 

Type-1 SVC switch. 

IOS page exception switch. 
Pseudo disable switch. 

SIR branch entry address. 
Type-1 exit entry point. 
Long TCB queue. 

Length of RVT. 


MACHINE STATUS BLOCK 


The machine status block contains hardware counters and values that 
are needed to keep track of the status of the processor. 


Bytes and 
Displacement Bit Patterns 
0 (0) 1 
1 (1) 3 
4 (4) 2 
6 (6) 2 
8 (8) 4 
12 (Cc) 4 
16 (10) 4 
20 (14) 4 
24 (18) 4 
24 (18) 1 
5 ere @ee#ee 
ai iene @eeee 
Pan lee @eee#ee 
paras, | @eeees? 
@eeee 5 earn 
@eee#ees Pe eae 
@eeees eo eXX 
25 (19) 3 
32 (20) 8* 
4O (28) 8* 
48 (30) 8* 
56 (38) 8+ 
64 (40) 8 
72 (48) 8 
80 (50) 8 
88 (58) 8 
96 (60) 4 
100 (64) 8 
108 (6D) 2 


*These fields are 4 
alignment. 


Field Nare 


MSBCPUID 


MSBSERNO 
MS BMODEL 
MSBLOGSZ 
MS BCOUNT 
MSBTHRLD 
MS BBUFER 
MSBBUFTH 


MSBMODE 


MSBMODE1 


MSBECCEN 
MSBECCDS 
MS BBUF E1 
MSBBUFD1 
MS BBUFE2 
MSBBUFD2 
MS BECCE2 
MSBECCD2 
MSBLFEVEL 


MSBS PARE 
MSBLNG 


Field Description 
Target of STORE CPU ID 


instruction. 

CPU serial number. 

Model number. 

Size of the extended logout. 
Soft error counter. 

Soft error threshold value. 
Buffer failure counter. 
Buffer failure threshold 
counter. 

Quiet/record mode control 
flags. 


Record mode for instruction 
retry. 

Buffer enabled. 

Quiet mode for main storage. 
Threshold mode for control 
storage. 

Diagnose instruction for plac- 
ing main storage in record 
mode not issued. 

Error frequency limit overflow 
condition. 

Reserved. 

Reserved. 

Enable the Model 158 ECC. 
Disable the Model 158 ECC. 
Enable the Model 158 buffer. 
Disable the Model 158 buffer. 
Enable the Model 168 buffer. 
Disable the Model 168 buffer. 
Enable the Model 168 ECC. 
Disable the Model 168 ECC. 
Change level of IGFMSB macro 
instruction. 

Reserved. 

Length of MSB. 


bytes long followed by 4 blank bytes for doubleword 
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MCH LONG RECORD 


See Figure MCH-9 for an explanation of the various MCH records. 


Displacement 


0 
0 


1 


2 
2 


3 


7 

8 
16 
16 
17 
20 
22 


24 
32 
40 
48 
328 


(0) 
(0) 


(1) 


(2) 
(2) 


(3) 


(4) 
(6) 


(7) 

(8) 

(10) 
(10) 
(11) 
(14) 
(16) 


(18) 
(20) 
(28) 
(30) 
(148) 


Variable 
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Bytes and 


Bit Patterns 


24 
1 


1 
ee eeee 


er i @eeees 


eeceoe XXXX 


| ee e@ee#s 
oa Dera @#eee¢ 


eeeese dea és 


@eeee Pe ere 
#eee eels 


#eee arena i 


oe XX @#eee 


j ee eeee 
re eee @eee 
Pa @eeese 


rere it eee 
@aee#ss Tae 
@eoe#s Pai 


e@ee2s Par) ie 


@ee#e Peres Oi 


1111 ee @8 


eeee 1111 


Nw WeE oor 


8 

8 

8 

280 
Variable 

80 


Field Name 


Header 
Record type 


Operating 
system 


Switches 


Program ID 
Job ID 
MCKPSW 
MCKFXLO 
MCKETLO 
MCHSTATD 


Field Description 


Record ID. 

X*°10° = MCH record. 
System ID: 

000-OS. 

Q01-DOS. 

010-OS/VS. 
011-CP67. 

Release level. 
Reserved. 


Record independent 
information. 

Multiple record. 

System/370 machine. 

Time macro instruction used 
(HHMMSS). 

Multiprocessing. 

BC mode version 2. 

EC mode. 

Reserved. 

Record dependent information. 
Short form of record. 
Record incomplete. 

MCH terminate system. 

First record of two record 
recording. 

Channel record included. 
Portion of data overlaid. 
External machine check. 
Model 67, Mod 2. 

Reserved. 

Record count: 

Sequence number of physical 
record. 

Total number of physical reco- 
rds in this logical record. 
Reserved. 

Date and time. 

CPU ID. 

Reserved. 

CPU serial number. 

CPU model number. 

Maximum machine-check extended 
logout. 

Program ID. 

Job ID. 

Machine-check old PSW 
Fixed logout. 

Extended logout. 

Damage assessment. 


MCH TESTING VECTOR TABLE 


The TVT (testing vector table) is used in MCH for testing only. It 
indicates whether simulation of machine conditions that cannot be artif- 
ically created on a real machine are allowed. It also indicates when MCH 


testing of the simulation mode is allowed. 


The address of the TVT is in 


the RVT (recovery vector table) at the symkolic location RVTITVT. 


Displacement 
0 (0) 


4 (4) 
8 (8) 
12 (Cc) 
16 (10) 
20 (14) 
24 (18) 


28 (1C) 
29 (1D) 


(ee 
Pa ee 


Bytes and 
Bit Patterns 


u 


Field Name 


TVTTEST 
TVTSOLID 
TVTS IM 
TVTPCN 


TVTMCN 
TVTWAIT 
TVTRTN 
TVTWPSW 
TVTRPSW 


TVTLEVL 
TVTSPARE 


Field Description 
TVT flag word. 


Solid MCI simulation active. 
MCI full simulation active. 
Address of MCH program check 
wait state new PSW. 

Address of MCH MCI wait state 
new PSW. 

Address of wait state PSW 
instruction. 

Address of return PSW 
instruction. 

Address of wait state PSW. 
Address of returm PSW. 

TVT level indication. 
Reserved. 
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MCH SECTION 6: DIAGNOSTIC AIDS 


This section is intended to aid in 
locating errors in MCH. Discussions on 
register conventions, problems that may 
exist when the IGF910W message appears, the 
MCH history table, and messages and wait 
state codes are included. 


REGISTER CONVENTIONS 


Figure MCH-14 shows how MCH uses its 
registers. Three modules are exceptions to 
these conventions: the Error Recorder, 
Console WRITE, and the MODE Command 
modules. They follow the conventions of 
the operating system. 


POSSIBLE PROBLEMS INDICATED BY MESSAGE 
IGF910W 


When the IGF910W message appears, the 
following can be done to isolate the cause 
of the error: 


1. Verify the interruption code. If the 
interruption code is invalid, the 
error was caused by a hardware 
malfunction. 


2. Check whether the fixed logout repre- 
sents the same machine check as the 
extended logout. 


3. Check the storage dump to see if a 
program check occurred. If so, and if 
the instruction address portion of the 
program-check new PSW is the same as 
the instruction address portion of the 
machine-check new PSW, the probable 
cause of the error is a program check 
in MCH. The history table in the MCH 
independent common area can then be 
checked to determine in which MCH 
module the program check occurred. 

The contents of the registers at the 
time the program check occurred can be 
found at location X‘'268‘ for VS1, and 
X*°260° for VS2. 


MCH HISTORY TABLE 


The MCH history table (MCHHISTY in the 
MCH independent common area) can be used to 
determine which modules have been executed 
Since the time of the machine-check inter- 
ruption and the sequence in which they were 
executed. The modules are identified by 
their IDs and level numbers. 


When MCH is initially entered, the Nuc- 
leus puts its own ID and level numer in 
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Free ee ep ge GN eg a Gg ase kn tg ee ere gage 1 
| Register | Used by MCH as | 
}---------- }------------------------------ { 
| 0-8 | Work registers | 
}---—------ }------------------------------ { 
| 9 | Address of the RVT | 
t---------- }------------------------------ 1 
| 10 | Pointer to the communica- | 
| | tions vector table | 
}---------- }------------------------------ { 
| 11 | Pointer to the MCH common | 
| | area | 
t----~----- }------------------------------ { 
| 12 | Nucleus base register | 
}---------- }------------------------------ : 
| 13 {| Address of the save area in | 
| | the I/O interface | 
}---------- +~------------------------------ : 
| 14 | Return address into the I/O | 
| | interface from transient | 
| | modules | 
}---------- 4------------------------------ { 
| 15 | Transient module base | 
| | register | 
a ee ee as ees eee es I Se ge Sead 


Figure MCH-14. Register conventions 


the two bytes following the table (MCHNXHIS 
and MCHEXLEV). When a successor module is 
specified, the I/O interface module moves 
this data into the last two bytes of the 
table, bytes 29 and 30. The ID of the suc- 
cessor module is put into MCHNXHIS anda 
hexadecimal ‘FF' is put into MCHEXLEV. 
After the module is successfully loaded, 
the successor module places its level numb- 
er into MCHEXLEV. This process is con- 
tinued. As each module is loaded, all the 
previous IDs and level numbers are moved 
two Eytes (toward a lower address). The 
I/O interface module always places the ID 
of the successor module into MCHNXHIS and 
the successor module always overlays the 
‘FF* of MCHEXLEV with its own level number. 
Figure MCH-15 shows the use of the MCH his- 
tory table. 


MCH MESSAGES AND WAIT STATE CODES 


Figure MCH-16 lists the messages that 
are produced by MCH and the modules that 
request each message. The code, where 
shown, is the wait state code informing the 
operator of an error condition that caused 
the system to ke placed in the wait state. 
The message will be lost if an I/O error 
occurs while writing to the console or if 
the control blocks for a graphic console 
have been paged out. 


J 


J 


Ee EES EE oe 


Figure MCH-15. 
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Figure MCH-16 (Part 1 of 2). 





21 22 23 24 25 26 27 28 29 30 31 32 
acetates TA teres tae aes tapes teeta tae tae taeeoaen taboos tape ap oten tae tae 
| EO | 01 | EY | O1 Di | 01 | F1 | 01 | DO | 01 | E3 | FF | 
eer ee 4 (A----4----4-_ 4d ddd ddd 
MCHHISTY MCHNXHIS MCHEXLEV 
(30 bytes) (1 byte) (1 byte) 


As this table shows, the following modules have executed in 


IGF952I 


MCH Nucleus - 
MCH I/O Control - IGFVMCE4 

Hardware Error Analysis - IGFVMCD1 

System Analysis - IGFVMCD1 

Soft Machine-Check Handler - IGFVMCDO 
Emergency Recorder - IGFVMCE3 (not yet loaded) 


The MCH history table shows the order in which 


IGFVMCEO 


executed. 


Message 


SUPERVISOR DAMAGE, 
(RUN SEREP,] RESTART 
SYSTEM 


SYSTEM INTEGRITY LOST, 
{RUN SEREP,] RESTART 
SYSTEM 


TASK jobname - ABNORMAL 
TERMINATION SCHEDULED 


TASK jobname - SET 
NON-DISPATCHABLE 


CATASTROPHIC I/0 
FAILURE, [RUN SEREP,] 


(USER ] ABNORMAL 
[SUBSYSTEM] 
TERMINATION SCHEDULED 


TSO 


SUCCESSFUL RECOVERY BY 
[HARDWARE] 
[SOFTWARE] 


TIMING FACILITY FAILURE, 
[RUN SEREP,] RESTART 
SYSTEM 


BUFFER BLOCKS DELETED 


———+———+—-—4 


bf HH YH HH 


ees ~--------------- 
Code| Requested By | 
----- +----------------+ 
A0O5 | IGFVMCEO | 
AO5 | IGFVMCF4 | 
| | 
----- +----------------+ 
AO1 | IGFVMCEO | 
AQ3 | IGFVMCEO | 
Ai1 | IGFVMCEO | 
----- +----------------+ 
| IGFVMCF4 | 

| | 
----- +----------------+ 
| IGFVMCF4 | 

| | 
----- +----------------+ 
AQ4 | IGFVMCEO | 
OAOC| IGFVMCF6 | 
| | 

| | 
----- +----------------+ 
| IKJVAMOO | 

| (TSO Subsystem) | 

| | 
----- }----------------+ 
| IGFVMCE5 | 

| | 

| | 
----- }----------------+ 
A16 | IGFVMCEO | 
| | 

A17 | IGFVMCEO | 
----- +-~--------------+ 
| IGFVMCDO | 

ee es 5 eee eee ee eee 


MCH Sect 


the following sequence: 


ee 


MCH messages and wait state codes 


Cause of Wait State Code | 

ae 4 
MCI in supervisor | 

MCI in supervisor | 

| 

SoS See Se eee eee y 
Hard on hard error | 

Program check in MCH | 

Erroneous MCIC | 

MAE ee ena ae, Sere ne rR Ree J 
| 

| 

ee Se Se ee ee -{ 
| 

| 

Pan a ee ee eee -{ 
I/O error in MCH | 

Unable to page module in, | 

VS1 system is less then | 

192K bytes. | 

ieee ee ee 4 
| 

| 

| 

aaa | 
| 

| 

| 

eS a Sa 4 
Time of day clock, clock | 

comparator, or CPU timer | 

Interval timer error | 

Sa es ie | 
| 

Jae Se See a eee J 
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IGF9531I STATUS: 
INSTRUCTION RETRY- [QUIET] 
[RECORD], 
MAIN STORAGE- [QUIET] 
[RECORD], 
CONTROL STORAGE- [QUIET] 
[THRESHOLD], 
BUFFER- [BLOCKS DELETED] 


a le 


| IGF954E SYS1.LOGREC DATA SET 
| [FORMAT ERROR ] 

| [RECORDING FAILURE] 
| 
| 


[NEARLY FULL ] 
{Is FULL ] 
IGF955I [CONTROL STORAGE ] 

{INSTRUCTION RETRY] 
[MAIN STORAGE ] 
Now IN 
[QUIET/THRESHOLD ] 
{ QUIET/RECORD ] 
MODE 

| IGF961I DAMAGED PAGE NOW 

| [UNAVAILABLE] 

| [DELETED ] 


Ee a ee ee a OS a” 


—_ 
' 
| 
| 
| 
! 
! 
! 
| 
! 
! 
' 
| 
! 
! 
| 
| 
| 
! 
' 
! 
| 
| 
| 
| 
! 
! 
! 
! 
| 
t 
! 
! 
! 
! 
! 
| 
| 
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| 
! 
! 
! 
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Figure MCH-16 (Part 2 of 2). MCH messages and 
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IGFVMCD4 
(IGF 2603D) 


+—————— ——+—4 


IGFVMCE2 


IGFVMCDO 
I1GC2603D 
(IGFVMCD4) 


-}— + —— — 4+ — — — —— —— + — — — — — 


wait state codes 


PART 2: 


CHANNEL-CHECK HANDLER 
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C 


PURPOSE OF CCH 


CCH (Channel-Check Handler) aids the I/0 
supervisor in recovering from channel 
errors and informs the operator or system 
Maintenance personnel of the occurrence of 
channel errors. 


CCH provides the device-dependent ERPs 
(error recovery procedures) of the I/0 
supervisor with the information needed to 
set up for retrying a channel operation 
that has failed; without the information 
provided by CCH, the ERPs would have to 
consider most channel errors as system ter- 
mination conditions. 


CCH provides the operator or system 
maintenance personnel with information 
about channel errors that enables them to 
keep statistics about the channel or helrs 
them to bring about recovery from system 
termination conditions. 


HOW CCH ACHIEVES ITS PURPOSE 


CCH receives control from the I/O super- 
visor when a channel data check, channel 
control check, or interface control check 
occurs. CCH produces an ERPIB (error reco- 
very procedure interface block) for the ERP 
and a record to be written in the SYS1. 
LOGREC data set for the operator or system 
Maintenance personnel. A copy of the reco- 
rd may be obtained by using the IFCEREPO 
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utility program. A message describing the 
channel error is issued each time a record 
is written into SYS1.LOGREC. 


Channels Supported by CCH and How CCH Uses 
the Information Provided by These Channels 


CCH supports the 2860, 2870, 2880, 135, 
145, and 155II channels. The 2860, 2870, 
and 2880 stand-alone channels can be 
attached to System/370 Medel 165II. Each 
cf these channels produces a logout at a 
Specific location in main storage (see 
Figure CCH-1) when a channel error occurs. 
This logout contains information akout the 
cause of the channel error and the condi- 
tions under which it occurred. CCH ana- 
lyzes the logouts of these channels and 
flaces the results of its analysis into the 
last three bytes of the ERPIB. 


System/370 Models 135, 145, 155II, and 
158 have integrated channels. The circui- 
try analyzes channel errors and presents 
the results of its analysis in the ECSW 
(extended channel status word). The ECSW 
contains the same information that CCH pro- 
duces for the stand-alone channels. For 
the integrated channels, CCH moves the last 
three kytes of the ECSW into the last three 
bytes of the ERPIB. 


The ERPIB 


Besides the analysis of the logout or 
the copy of the ECSW, the ERPIB contains 


a aaa a pe ee a Rr i eee cae aaa aaa aa ae a aaa “7 
| | Logs Out at | | | | | 
| ~-------7---------4 | | | | 
i [ |Location | | | | | 
| | [Pointed | Logs Out for | | | | 
| Channel |Location | to by i Bytes | CSW at | ECSW at | Unit Address at | 
}--------- +--------- $--------- ---=-==------------- +-------- }--------- 4----------------- { 
| 2860 | 304 | | 24 [ 64 | | | 

----—--- ta-- 23-4 fn nn nf nna nnn fff 
| 2870 ] 304 | i 24 | 64 | [ [ 
}--------- $--------- $--------- }-------------------- $------— $--------- $---------------- ~ 
| 2880 | [ 172 | 112 | 64 | | | 
[--------- {--------- $--------- $--------~----------- +-------- +--------- $----------------- { 
| 135 [ 256 | 172 | 24 | 64 | 176 | 184 | 
}---------}---------4---------}--------------------} -------- 4-----—--}-------—---------| 
| 145 | | 172 | 96 | 64 i 176 | 184 [ 
l I | | maximum | | | | 
}--------- +--------- 4_-----~-- 4—.------------------ $-------- $--------- }---------------- + 
{155I1I/ | 155II/158 channels do not logout | 64 | 176 | 184 | 
| 158 | | | | | 
}---_--_---- Beige lant ng nee nee epee a Pn a So pee ees 0 ee eee ere Be ee ee 4 
| Note: All locations are decimal. | 
a a ae a ee eee eee ea ee eee ees J 


Figure CCH-1. 


Channel logout locations and other fertinent locations referred to by CCH 
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program flags and the address of the unit 
control block. The ERPIB is illustrated in 
CCH Section 5. 


The Channel Error Inboard Record 


The inboard record contains a copy of 
the last half of the ERPIB, information 
about the status of the system at the time 
of the channel error, and a copy of the 
channel logout. The inboard record is 
illustrated in CCH Section 5. 


I/O SUPERVISOR AND MCH PROCESSING OF 
CHANNEL ERRORS 


CCH performs no error recovery; it does 
not retry any operations, make any changes 
to the system, or even write its own reco- 
rds or message. Recovery from channel 
errors is performed by the routines of the 
I/O supervisor. Termination of the system 
because of channel errors is performed by 
the routines of the Machine-Check Handler. 


Figure CCH-2 is a simplified illustra- 
tion of the flow of control between the 
Channel-Check Handler, the Machine-Check 
Handler, and certain I/O supervisor rou- 
tines. The following discussion provides 
some background on the routines that work 
with CCH. They include I/O supervisor rou- 
tines that handle normal I/O operations and 
channel errors, and the ERPs that process 
channel errors and use the information CCH 
provides in the ERPIB. 


I/O Supervisor Normal I/O Processing 


When an application or a system program 
requests an I/O operation, the I/O supervi- 
sor executes a Start I/O instruction which 
causes a chain of channel commands to be 
executed. After execution of all the com- 
mands, an I/O interruption occurs. If the 
I/O supervisor determines that there were 
no errors, it notifies the requester that 
the I/O was successful. The I/O supervisor 
then passes control to the Dispatcher. 


I/O Supervisor Channel Error Processing 


As illustrated in Figure CCH-2, if a 
channel error occurs during execution of a 
command, Or on the interruption following 
command execution, normal processing is 
suspended while the error is handled. The 
I/O supervisor passes control to CCH to 
analyze the error and to construct an 
ERPIB. The I/O supervisor then schedules 
an ERP. 


The ERP determines whether the operation 
can be retried. If it cannot (because it 
is unretryable or because it has already 
been retried the specified number of 
times), the ERP passes control to the WTO 
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(Write-to-Operator) routine, which issues a 
message declaring a permanent error. The 
WTO routine then passes control to the Sta- 
tistics Update routine. 


If the operation can be retried, the 
error recovery procedure prepares for the 
retry and returns control to the I/O super- 
visor, which retries the operation. After 
the retry, the ERP again gains control. If 
the retry was successful, the ERP passes 
control to the Statistics Update routine. 
If the retry was unsuccessful, but the 
operation can be retried again, the ERP 
returns control to the I/O supervisor. The 
Statistics Update routine updates the sta- 
tistics takle for the device and passes 
control to the Outboard Recorder. 


The first load of the Outboard Recorder 
checks whether it was entered because of a 
permanent error. If so, it formats an out- 
board record to record the error as per- 
manent. It updates the statistics for 
SYS1.LOGREC data set by adding the counts 
recorded in the statistics table to the 
statistical values already in SYS1.LOGREC. 
It passes control to the second load of the 
Out board Recorder. 


The second load of the Outboard Recorder 
writes any outboard records and updates the 
Statistics in SYS1.LOGREC. It then deter- 
mines whether it was entered because of a 
channel error. If so, it writes into 
SYS1.LOGREC all inboard records produced by 
CCH and again updates statistics on 
SYS1.LOGREC. The Outboard Recorder then 
issues message IFBO02I to inform the opera- 
tor that a channel error has occurred, and 
clears the inboard record area. When 
finished (or if there were no channel 
inboard records to be written), the Out- 
koard Recorder gives up control via SVC 3 
(EXIT). 


How an ERP Handles a Channel Error 


If the ERP determines that it was 
entered because of a channel error, it 
searches for the ERPIB that CCH constructed 
for that error. It searches the ERPIB 
table for a UCB address that matches the 
UCB address in the RQE (request element). 
(The UCB address is in the second, third, 
and fourth bytes of the ERPIB.) If a 
matching UCB address is not found, the 
error must be treated as permanent, because 
the ERP cannot set up for the retry without 
an ERPIB (except for channel data checks, 
for which the ERP does not require such 
information to set up for a retry). If the 
ERPIB is found, the ERP makes certain 
tests, evaluates the termination and 
sequence codes in the ERPIB, and verifies 
the channel status word. These steps are 
illustrated in Figure CCH-3. 
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Figure CCH-2. Overview of CCH-MCH-IOS processing of I/O errors 
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CCH-3. 


Figure 


Standard tests made by an 
ERP when entered following 
a channel error 


It is important to remember that CCH is 
channel dependent, whereas the ERPs are 
device dependent. CCH may analyze the 
error, determine that the channel error can 
be recovered from, and pass its information 
to the ERP in the ERPIB. When the ERP 
examines the information in the ERPIB, 
however, taking into consideration the 
device that is involved in the error, it 
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May determine that a retry cannot be 
attempted. Or, after several retries, the 
ERP may determine that the required number 
of retries for that device has been made 
without success and indicate that a per- 
Manent error exists. (CCH may have deter- 
rined already that retry is impossible; it 
would have (1) not put the ERPIB in the 
ERPIB table or (2) set the “no retry" bit 
in the ERPIB.) 


Each ERP has three exits: 


e For errors that are permanent, it 
fasses control to the Write-to-Operator 
routine to indicate to the operator 
that a permanent error has occurred. 


e For errors for which operations must be 
retried or for which repositioning is 
necessary, it causes SVC 15 (ERREXCP) 
and SVC 3 (EXIT) to be issued. 


e For errors that have been corrected, it 
passes control to the Statistics Update 
routine. 


Before the ERP passes control, it clears 
the ERPIB to 0's, regardless of the result 
of the retry attempt. This frees the ERPIB 
and prevents the possibility of two ident- 
ical UCB addresses existing in the ERPIB 
takle. 


CCH FIXED STORAGE REQUIREMENTS 


Following nucleus initialization, the 
CCH modules reside in the nucleus. The 
amount of storage required by CCH defends 
on the type of channel that is included in 
the system. Figure CCH-4 illustrates the 
amount of storage needed for the possible 
channel configurations. 


Cg a a Ma gg ye eget sar re en ee era St era ee 7 
| Channels | Number of Bytes Needed to Support Each Channel | 
|-------------------------- }------------------------ ----- $9 $$ nen nnn nn { 
| | CCH Central Module + Analysis + Logout + Inboard | 
| | (IGFVCCHC) Routine Area Record Area | 
paoe SSS ee a ae ane paper e eak To H=S====5= === --== sae anaes ela aa { 
| 135 | 2100 | 105 | 24 | 351 | 
}-------------------------- $---------------------- +---------- t-------- $----------------- { 
| 145 | 2100 | 164 | 96 | 567 | 
|-------------------------- t---------------------- +---------- +-------- $----------------- { 
| 155II and 158 | 2100 | 62 | 0 | 279 | 
}-------- q----------------- }---------------------- ---------- +-------- }----------------- { 
| | 2860 | {| 1026 { | | 
| Model) [}|----------------- 4 }---------- { 24 | 339 | 
{| 165I1I{ | 2870 | 2100 | 1026 | | | 
| and ( }---------------- 4 }---------- t-------- to--a2------------ { 
{| 168 {| 2880 | | 1026 {| 112 | 603 | 
a eee ee a et | Cea eee OU es at fee eee ee = 
Therefore: 
re ge ee ee ee eG ma aa a gi a 1 
| If the system includes: | The total bytes needed for CCH are { 
}------------------------------------------- }------------------------------------------- { 
| 135 channels | 2100+105+24+351 = 2580 | 
| ------------------------------------------- }------------------------------------------- { 
| 145 channels | 2100+164+96+567 = 2927 | 
}------------------------------------------- }------------------------------------------- { 
| 155II/158 channels | 2100462404279 = 2441 | 
|------------------------------------------- +---------- + -------------------------------- { 
| 2860 or 2870 channel | 2100+10 26+ 244339 = 3489 | 
}--------~---------------------------------- }------------------------------------------- { 
| 2860 and 2870 channels i 210042 (1026) +244+339 = 4515 | 
|------------------------------------------- }------------------------------------------- { 
| 2880 channel | 2100+1026+112+603 = 3841 | 
|------------------------------------------- {------------------------------------------- { 
| 2860 & 2880 channels | | 
| Or | 2100+2(1026)+24+112+603 = 4891 | 
{ 2870 & 2880 channels { | 
|----------=-------------------------------- {------------------------------------------- { 
| 2860 & 2870 & 2880 channels { 2100+3(1026) +244+112+603 = 5917 | 
| --~-----------------~---------------------- 4—-—---—-----—-~-----------~---~--~--------- { 
| « Only 24 bytes of logout area are needed for use by the 2860 and/or the 2870. | 
| | 
| # Only 339 bytes of inboard record area are needed for use by the 2860 and/or the | 
| 2870. | 
| | 
{| « If the 2880 channel is in a system with a 2860 or 2870 or both, only 603 bytes of { 
| inboard record area are needed, but the 2880 needs its own 112 bytes of logout area | 
| in addition to the 24 bytes for the 2860 and/or 2870. | 
i a i a It Nh eh J 
Figure CCH-4. CCH fixed storage requirements 
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CCH SECTION 2: METHOD OF OPERATION 


This section descrikes the functions of 
CCH and how CCH performs these functions. 
Many references are provided to material in 
other sections of this publication and to 
the CCH program listing. Two types of 
information are presented: 


e Text that discusses the design of CCH. 


e Method of operation diagrams that show 
the functions performed by CCH in the 
order that they occur. The module name 
and label of each processing step are 
included in the implementation notes 
for each diagram. These diagrams can 
be used for quick reference when 
reviewing CCH functions. Diagram CCH-1 
shows how the method of operation dia- 
grams for CCH are organized. 


FUNCTIONS OF CCH 


The Channel-Check Handler has two pri- 
Mary functions: analyzing the channel fai- 
lure and recording the results of this ana- 
lysis for use by an ERP and the operator or 
system maintenance personnel. 


CCH first analyzes the status of the 
channel, as shown in Diagram CCH-3. Using 
the information in the channel logout or 
the extended channel status word, and con- 
Sidering the type of channel error and 
which I/O supervisor routine was executing 
when the channel error occurred, CCH must 
determine whether the channel error is 
recoverable. If CCH determines that the 
channel error is recoverable, it returns 
control to the I/O supervisor at the 
correct displacement to allow the I/0 
Supervisor to schedule an ERP. If CCH 
determines that the channel error is not 
recoverable, but that operations may con- 
tinue (for example, when a channel error 
occurs in the Sense routine), it returns 
control to the I/O supervisor at the "no 
retry" displacement or with the "no retry" 
indicator set in the ERPIB. If the error 
is asynchronous and cannot be associated 
with a specific task, CCH returns control 
to the I/O supervisor at the "alternate 
return" displacement, so that the I/0 
Supervisor can restart the channel, essen- 
tially ignoring the error. 


If CCH determines that a system termina- 
tion condition exists, it ensures that an 
inboard record is complete and then passes 
control to the Machine-Check Handler to 
write the record and to place the system in 
a disabled wait state. 
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device is in a recoverable position. 


Also, in the process of analyzing the 
channel error, CCH must decide whether to 
place the ERPIB in the ERPIB table for the 
ERP to use in setting up for retrying the 
Cperation. CCH does not place the ERPIB in 
this table if the channel error is a system 
termination condition or if the ERP can set 
up for retrying the operation without an 
ERPIB. 


CCH passes the results of its analysis 
to the I/O supervisor in the ERPIB; the 
results of the analysis determine the point 
in the I/O supervisor to which control is 
returned. The I/O supervisor can then 
decide whether to schedule an ERP. The 
ERP, using the information in the ERPIB, 
makes the final decision as to whether the 
Dia- 
gram CCH-4 shows the steps for constructing 
an ERPIB. 


Whatever the results of its analysis, 
CCH always attempts to provide the operator 
Or maintenance personnel with a record of 
the channel error. Diagram CCH-5 shows the 
steps for constructing a channel error 
inboard record. 


CCH ERROR ANALYSIS 


The first step in analyzing the channel 
error is to determine what bit was set in 
the channel status word -- bit 44 (channel 
data check), bit 45 (channel control 
check), or bit 46 (interface control 
check). Using this information, CCH checks 
for a system termination condition by 
determining if (1) the channel is supported 
by CCH, (2) the logout or ECSW was stored 
completely, and (3) the UCB address is 
valid, as well as by using the information 
in the logout or the ECSW. Figure CCH-5 
illustrates the differences in CCH execu- 
tion for the various channels and channel 
checks. 


CCH always builds a work ERPIB. The 
ERPIB takle has space for five ERPIBs. The 
work ERPIB is intended to be placed in the 
ERPIB takle for use by an ERP and in the 
inboard record for use by the operator or 
system maintenance personnel. In some 
cases, however (system termination condi- 
tions, nonretryable conditions, or when the 
error recovery procedure does not need an 
ERPIB to set up retrying the operation), 
the ERPIB is not placed in the ERPIB table, 
but 1s built only for inclusion in the 
inboard record. 


J 


a aa SRS es oe > a Misc et eee ry eho aS Te ae ee Baca as Weta = ate oe eA MS awe ee, 7 


| | 2860 | 2870 | 2880 | 135 | 145 | 155117158 | 
| enn tenn rn rt rth tt thn rt tnt tol 
| Actions Taken by CCH or Channel |CDC|CCC| Icc|cbDc|ccc| Icc|cbc|ccc |Icc|cbDc|ccc| Icc|cDc|ccc| Icc| cDc| ccc| Icc| 
|----------- = npn pnp nn pn npn pint ttinn stn rns tn tn thn tn tn tn td 
| Channel logs out. | } x | x | } x |x fxftxiti{x t | x | x | | x | x | | | | 
pean nn nn finn fn fn natn fn n thar ethan thant tn thn thet tn ttn tan te al 
| CCH analyzes the logout. | | x | x | | x | x | | x | x | | | | | | | | | | 
PIRI h AAS SAGs 4 AcE ERE ERE aek Passa a as tat at tat aa aa 
| CCH moves the ECSW. | | | | | | | | | | x | x | | x | x | | x | x | 
A sas a SSR aus! amram TUS Aa cag? ean Seis amass Cosa apa emg) mses ed alas Ct ima Coat 
| CCH constructs a work ERPIB. }xf{xixt]xixitxixt]xixi{xitxei{ixeixitxi{ixixt[{[x [x 'i 
se aa Ro aa OLS Re : SEG) GECAS cMMSa] Cacienech Cacao (SS COCR: GROIN? CATR GEERT! (oneal: Canaan’ Goxicaies (aa alan) Ga mame fais 
| CCH places the ERPIB ina list | |} x | x | | x | x | ,} x | x | | x | x | } x | x | | x | x | 
| for the ERP (unless a system | | | | | | | | | | | | | | | | | | | 
| termination condition exists or | | | | | | | | | | | | | | | | | | | 
| the ERP does not need an ERPIB | | | | | | | | | | | | | | | | | | | 
| to set up for retrying the | | | | | | | | | | | | | | | | | | 
| operation). | | | | | | | | | | | | | | | | | | | 
} seas sn nn sn 5 a f ff ta ttn ten tea tet tt ttt tt 
| CCH creates the ERPIB to be | x | | | x | | | x | | [x] | | x | | | x | | | 
| placed in the inboard record | | | | | | | | | | | | | | | | | | | 
| only. | | | | | | | | | | | | | | | | | | | 
Sg a aa la Sess Comte cme iene (tna cana i Caria ia ca Naas coca Cas Geass Gece Gana ea oa 
| CCH attempts to construct an }xftxixi]x{]x]txi{ix{txi{txixix«]x«[xixitxftx*« [x it[{x i 
| inboard record. | | | | | | | \ | | | | | | | | 
Fea Sse Se a ee ee ee a ee 
| CCH places the logout in the | |} x |x | | x | x | x | x { x | | x | x | | x | x | | | | 
| inboard record. | | | t | | | | | | | | | | | | | | | 
|+-------------------------- ------ -1---4-~-141---1---4-—-14---1---1---4---4---14---1--- aa —---1i---1---1---1~--] 
{| CDC (channel data check) is indicated by bit 44 of the channel status word. | 
| ccc (channel control check) is indicated by bit 45 of the channel status word. | 
| Icc (interface control check) is indicated by bit 46 of the channel status word. | 
oo Ss Se eo ee ee eo oe ee eee ee ee eee ee ee ee Se Sea eee oe ee a Se a SS SS SS SS ee 
Figure CCH-5. Differences in CCH execution for the various channels and channel checks 
CCH also always attempts to build an in the byte when CCH gains control. This 
inboard record. The inboard record area procedure is illustrated in Figure CCH-6. 
has room for three inboard records. Under 
certain conditions, however, space for an 
inboard record is not available. When Returning Control to the I/O Supervisor 
space for one is available (or when CCH 
clears a space for use because the channel The UCB Search routine of IGFVCCHC 
error is a system termination condition and returns control to a point in the I/0 
the Machine-Check Handler must have a reco- supervisor. The appropriate CCH 
rd to write into SYS1.LOGREC), CCH copies interception-dependent routine, upon 
into it the channel logout (for those chan- receiving control from the ERPIBSET routine 
nels that log out), the last four bytes of of IGFVCCHC, has set a displacement in 
tne ERPIB, and other information of inter- register 12; the displacement depends on 
est to the operator or system maintenance the information collected by the CCH ERPIB- 
personnel. SET routine and the appropriate analysis 
routine. The UCB Search routine adds this 
displacement to the I/O supervisor base 
return address in register 14 before 
Passing Controi to CCH from the I/O returning control to the I/O supervisor. 
Supervisor The return displacements are as follows: 
CCH receives control from the I/O super- Name Value Return for 
visor through the System Environment Reco- CCHRTHIO 0 Halt I/0 
rding Interface routine (SERROYW). The 
channel error could have been intercepted CCHRTSIO 0 Start I/O or Test I/0 
at any one of seven points within five rou- 
tines of the I/O supervisor. To allow CCH CCHRTINT 4 Interruption 
to determine where the channel error was 
intercepted, the executing routine of the CCHRTSNN 12 Sense, no retry 
I/O supervisor places a value into a field 
labled CATAPP before an interception point CCHINT2 16 CCH received control on an 
is reached. If no channel error occurs, asynchronous interruption 
the value is overlaid by the value of the for which no UCB or RQE 
next routine that gains control; if a chan- could be found (the inter- 
nel error does occur, the proper value is rupt may have been for an 
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Instructions are at strategic positions in the five routines shown 


below to cause values to be placed into the CCH entry indicator , User cies Alina cag aaa AE oie cea ere 3 
BCA TAPP) Theo valccnae seta) eee interface control check, one of the I/O supervisor routines will 
: p y invoke CCH via SERRO4. 


various routines are executed. 






Start I/O Routine for Direct Access Devices 





After TIO———MVI CATAPP, CATTIOSK 
After S|}QO———MVI CATAPP, CATSSK 









Post Start I/O Routine 
CCH Entry Indicator Byte 


CATAPP 


The value in CATAPP 

indicates the routine that 

intercepted the channel 
(eee 












4 





After SIO 





MVI CATAPP, CATSIO 








check. CCH automatically 
invokes the right CCH 
interception-dependent 
routine by using that value 
as an index to a list of 
branch instructions. 






1/O Interruption Supervisor 





After Interrupt MVI CATAPP,CATINT 







=|— 



















Sense Subroutine B *+4 (INDEX) 
After TIO MVI CATAPP, CATTIOSN 12 A i SeGHRe 
After S|} Q——— MVI CATAPP, CATSNS 8 : 
A> 4B SCCHIIOSK ===) (“pprepmate 
MVI CATAPP ,CATREC 28 
: 8 B CCHSNS ——* | CCH 
12 B CCHTIOSN -—> Interception- 
Halt [/O Subroutine 16 B CCHSIO Dependent 
20 B CCHINT i Routine 
24 B CCHHIO —__» 
After HIO MVI CATAPP, CATHIO 24 





Figure CCH-6. How CCH knows from what I/O supervisor routine it was entered 


J 


address that does not The address of the inboard record is con- 
exist). This return tained in RVTCCHRC. Figure CCH-7 illus- 
allows the I/O supervisor trates the CCH-MCH interface in the RVT. 


to restart the channel 
without passing control to 
an ERP; the interruption 


is essentially ignored. Recovery Vector Table (RVT) 


20 (14) RVTCCHRC 


Interfacing with the Machine-Check Handler ‘ : 
Pointer to CCH inboard 
‘ : record when CCH passes 

AS soon as CCH is entered following a control to MCH. 


chanel error, it sets bit 0 of byte O of 
the RVTWSFLG field in the RVT (recovery 
vector table) to 1 to identify itself to 
the Machine-Check Handler should a machine 
check occur during CCH exeuction. The UCB 
Search routine of IGFVCCHC resets the bit 
to 0 just before it releases control. CCH has determined that the error » 
is a system termination condition. 
If the UCB Search routine of IGFVCCHC MCH places the system in a disabled 

finds that CCH has determined the channel wait state. 

error to be a system termination condition, 
it sets bit 1 of byte 0 of RVTWSFLG to 1 to 
indicate the situation to the Machine-Check A machine check occurred 
Handler, and sets bit 0 of byte 0 to Q. while CCH was being executed. 
The UCB Search routine then places a X'‘0F' 
in the machine-check new PSW (location 115) 
for SEREP and kranches to the Machine-Check ) 





Handler using the address in RVTSHUT. It Figure CCH-7. CCH-MCH interface in the 
places the system in a disabled wait state. RVT 
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c 


Determining Whether the Channel Has Logged 
Out or Stored the ECSW Successfull 





The CCH initialization module (IGFVCCIN) 
sets the logout area to all i's at nucleus 
initialization. When entered, the appro- 
priate CCH analysis module checks the 
logout area. If any*“word of the logout 
area contains all i‘s the channel has not 
logged out successfully. After analyzing 
the logout, the CCH analysis module 
restores the logout area to all i‘s so that 
the test can be repeated if another channel 
error occurs. 


Similarly, the CCH initialization module 
sets the first byte of the ECSW area to all 
i‘s. When entered, the CCH analysis module 
checks the first bit of the ECSW; if it is 
1, the ECSW has not been stored successful- 
ly. After moving the ECSW to the ERPIB, 
the CCH analysis module restores the first 
byte to all i‘s so that the test can be 
repeated. 


Why There Might Not Be an ERPIB Available 


Channel errors could be occurring faster 
than error recovery procedures can be sche- 
duled; therefore, all five ERPIBs could be 
in use. If all five ERPIBS are in use, CCH 
searches the error logical channel queue 
for a UCB address in one of its RQEs that 
matches the UCB address in one of the 
ERPIBs. If CCH does not find matching UCB 
addresses, CCH frees one of the five ERPIBs 
by clearing it to 0‘s. Each of the five 
ERPIBS is thus compared and freed if poss- 
ible until all ERPIBs that can be freed are 


freed. Finally, CCH searches the ERPIB 
takle for the last available ERPIB to use. 


There is also the possibility that there 
is no ERPIB available because the ERP neg- 
lected to clear the ERPIB when it was 
finished processing the error; this should 
never occur. 


Why There Might Not Be an Inboard Record 


Available 


When the Data Collection routine of 
IGFVCCHC finds that all three inboard reco- 
rds are full, it sets the “no record avail- 
able" switch to indicate that an inboard 
record will not be produced for this error. 
Only if the “system termination" switch is 
set does the Data Collection routine clear 
cne of the inboard records and use it. 


This situation (of all records being 
full) occurs when CCH is entered four or 
rore times for what is essentially the same 
channel error. For an operation that must 
be retried a maximum of ten times by an 
ERP, for example, CCH can be entered 11 
times for the same kind of channel error on 
the same failing operation. Each time, a 
new ERPIB iS created, used, and cleared. 
However, Since inboard records are fending 
until all retries of the operation have 
been made, and since there are only three 
inboard records available to CCH for reco- 
rding any one error, only the first three 
channel errors (the first error and errors 
on the first two retriesS) are recorded as 
inboard records. 
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CCH METHOD OF OPERATION DIAGRAMS 


These Method of Operation Diagrams show 
the functions of CCH and relate these func- 
tions to the exact modules and entry points 
in the code where they are performed. 


These particular diagrams are known as 
HIPO.diagrams because they show Hierarchy 
as well as Input, Processing, and Output. 
The first diagram is a visua] table of con- 
tents. The rest of the diagrams are 
arranged in a hierarchy according to the 
level of detail. 


Read the diagrams left to right, input- 
processing-output. The processing steps 
are numbered sequentially; these numbers 
also refer to the implementation notes at 
the bottom of most of the diagrams. The 
notes contain additional information about 
the processing steps. 


The arrows are used as follows: 


E> =: control flow to or from 
another program. 
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C—> 


ET VT 


, 


Primary processing flow. Shows 
the path followed to accomplish 
the principal function of the 
body of code. 


Data transfer. Indicates that 
data is moved from one location 
to another. 


Control information transfer. * 
Indicates the setting or changing 
of switches or pointers that will 
be used to determine the course 
of future processing. 


Pointer. Indicates that a field 
in one data area contains an 
address that points to another 
field or data area. 


Data reference. Indicates that 
the contents of a data area are 
tested or read in order to deter- 
Mine the course of subsequent 
processing. 
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Method of Operation 


Ze 


CCH Section 





CCH SECTION 3: PROGRAM ORGANIZATION 


ORGANIZATION OF CCH 


CCH consists of one initialization 
module (IGFVCCIN), one central processing 
module (IGFVCCHC), and six channel error 
analysis modules (IGFVCC60, IGFVCC70, 
IGFVCC80, IGFVCC35, IGFVCC45, IGFVCC55). 


The initialization module is brought 
into the system by nucleus initialization 
and is deleted after initialization; its 
function is to aid NIP in initializing CCH 
by indicating what CCH channel error analy- 
Sis routines are to be brought into the 
nucleus and what logout areas are to be set 
up. The central module includes (1) rou- 
tines that locate and fill part of the 
ERPIB and the inboard record as they ana- 
lyze the channel error, (2) interfaces with 
the I/O supervisor and the Machine-Check 
Handler, and (3) data areas. The analysis 
modules analyze the channel logout or move 
the ECSW to complete the ERPIB and also 
move the logout to the inboard record. 


The execution of IGFVCCHC, following 
some initial functions, begins at one of 
four interception-dependent routines. The 
interception-dependent routine passes con- 
trol to and receives control back from the 
ERPIBSET routine. The ERPIBSET routine in 
turn passes control to and receives control 
back from an analysis module. Finally, the 
interception-dependent routine, having 
reviewed the information collected by the 
ERPIBSET routine and the analysis module, 
passes control to the UCB Search routine. 
The UCB Search routine checks flags set by 
the other CCH routines to decide whether to 
return control to the I/O supervisor (and 
at what displacement, using a value set by 
the interception-dependent routine) or to 
pass control to the Machine-Check Handler. 


Figure CCH-8 illustrates the processing 
Gone by each of the CCH routines to accomp- 
lish the functions shown in the method of 
operation diagrams. 


INCLUDING CCH IN THE SYSTEM-DYNAMIC LOADING 
CCH uses a technique cailed dynamic 


loading to save space in the nucleus. 
Dynamic loading involves bringing into the 
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nucleus only what is needed for any single 
System configuration. 


During system generation, IGFVCCHC is 
placed in the resident nucleus, and IGFVC- 
CIN and all six analysis modules are placed 
on SYS1.LINKLIB. During nucleus initiali- 
zation, NIP, using the IGFVNIP macro 
instruction, brings IGFVCCIN into the resi- 
dent nucleus. IGFVCCIN determines which 
analysis modules are needed for the system 
configuration Ly issuing the STORE CHANNEL 
ID and STORE CPU ID instructions. The 
channel configuration word is filled in to 
show which channels are presently in the 
system; it is illustrated in Figure CCH-9. 
IGFVNIP then brings the indicated analysis 
modules into the resident nucleus. Final- 
ly, IGFVNIP deletes IGFVCCIN from the resi- 
dent nucleus. 


This loading technique is illustrated in 
Figure CCH-10. For a more detailed discus- 
Sion of CCH initialization, see OS/VS IPL 


and NIP Logic. 


CCH COMMUNICATIONS SCHEME 


In order to establish pointers to the 
analysis routines, the ERPIB table, and the 
inboard record area, a CCH communications 
area is produced before and during CCH 
initialization. During system generation, 
the address of the first word of the 
SYS1.LOGREC data control block is placed in 
the communications vector table at displa- 
cement 116. The first word of the 
SYS1.LOGREC DCB contains the address of a 
five-word parameter table, which is the CCH 
portion of the I/O recovery management sup- 
port communications area (IORMSCOM). 


The areas referred to in the parameter 
table all reside in the resident nucleus 
before CCH is initialized. During nucleus 
initialization, the inboard record area and 
the analysis modules are appended to the 
nucleus by the IGFVNIP macro instruction, 
and their addresses are saved in the CCH 
communications scheme. 


The CCH communications scheme is illus- 
trated in Figure CCH-11. 
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CCH Section 


ee a ee ee ee ee ee ee ee ee ee es ee ee sn ae een se Sn een a ee ee ee 


br} 


CCH Parameter Table 





es es ee Oe Oe Oe re ee ee ee ee 
Lf tf — t FT tf tot ee ee ee ee ee 
lf tf -F| FY | I bo ~— §[— | | | | to tt 


a a a a a a a a a ee es cs as / cen Cane enero 
0 4 8 12 16 20 24 28 32 36 40 44 48 52 26 60 


| ce =, c tee fp oe wr op ae oe ae ee 
| 


The channel configuration word is 64 bits long. Each half-byte represents one 
channel. Each channel is represented by a four-kit hexadecimal digit as follows: 


Four Bit Hex Count Channel Assignment 
No channel attached 
Integrated multiplexer channel 
Integrated seiector channel 
Integrated block multiplexer channel 
Reserved 
2860 selector channel 
2870 multiplexer channel 
2880 block multiplexer channel 
2880 selector channel 
Reserved 
Integrated file adapter 

-E Reserved 
Unrecognized channel attached 


igure CCH-9. Channel configuration word 
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ame mre res re cr gs rs rm gs 2 | ee 


At End of System Generation 









ee 








Nucleus 


At Nucleus Initilization 


NIP loads IGFVCCIN 

during nucleus initialization. 
NIP deletes IGFVCCIN 
during initial program 
loading after IGFVCCIN has 
completed its functions. 


The IGFVNIP macro of NIP 
(using information passed to 
it by IGEVCCIN) brings in 
whatever channel error 
analysis routine(s) are 
required for the channels 
indicated by the STORE 
CPU ID and STORE 
CHANNEL ID instructions. 





Analysis 
Routine(s) 


SYS1.LINKLIB 


Nucleus 


Figure CCH-10. CCH dynamic loading 
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CCH MODULE DESCRIPTIONS 


The following module descriptions summarize the functions of each CCH module. Addi- 
tional information about CCH modules can be found in the method of operation diagrams and 
in the prologues for each module. Prologues can be found on the microfiche. 


CR SS ea a ee ee eee Ro ee a epee 1 
| IGFVCCIN - CCH Initialization | 
|--------------------------------------------------------------------------------------- { 
| , , | 
| © Determines which analysis modules are needed for the channels in the system. | 
| | 
| @ Informs IGFVNIP which analysis modules are needed (for IGFVNIP to bring into the | 
| nucleus). | 
| | 
{| © Informs IGFVNIP how much real storage is needed for the inboard records and | 
| logouts, and indicates the sizes of the logouts and the size of one inboard | 
| record. | 
| | 
(Sopa oe a Mpa e ase ace ie ne ey Gace pas er ee 4 
| Entry Point | Entered From | Exits To | 
| ------------~--------------- +---------------------------- ------2-------------=-------- { 
| IGFVCCIN | IGFVNIP | IGFVNIP with the parameter | 
| | | list filled. | 
be ee ee eS Decree eee Ia res ee J 
ee re ee eg ie ne ES ee ee 1 
| IGFVCCHC - CCH Central Processing | 
Fe ee ce hs dan ee ee tae, | | 
| « Sets a bit to signify that CCH had control in case a system termination condition | 
exists. | 
| | 
| @« Checks for a valid UCB address. | 
| | 
| | . | 
| ERPIB Entry Find routine | 
| 
| « Determines the address of an available ERPIB. | 
| | 
| | 
| Data Collection routine | 
| | 
| «© Determines the address of an available inboard record. | 
| | 
| « Places general information in the inboard record. | 
| | 
| | 
| Branch Table routine | 
| | 
| « Branches to the correct interception-dependent routine using the value set by the | 
| I/O supervisor in CATAP. | 
| | 
| | 
| Interception-Dependent routines | 
| | 
| Start I/O and Test I/0 | 
| | 
| e Sets the SIO or TIO bit in the work ERPIB. | 
| | 
| e Passes controi to the ERPIBSET routine to complete the ERPIB. | 
| 
| e Sets the SIO or TIO dispiacement for return to the I/O supervisor. | 
| | 
| e Passes control to the UCB Search routine. | 
beeen eee eee J 
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e Stores 
e Checks 
e Places 


e Passes 


record 
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Interception-Dependent routines (Cont‘d) 


e Sets the SIO or TIO bit in the work ERPIB. 
e Indicates that the ERPIB is for the inboard record only. 
e Passes control to the ERPIBSET routine to complete the ERPIB. 


e Sets the “no retry" displacement for return to the I/O supervisor and the “no 
retry” bit in the ERPIB. 


e Passes control to the UCB Search routine. 


Interruption 


e Sets the interruption bit in the work ERPIB. 
e Passes control to the ERPIBSET routine to complete the ERPIB. 


e Sets the interruption or alternate return displacement for return to the I/0 
supervisor. 


e Passes control to the UCB Search routine. 


Halt I/0 

Sets the HIO bit in the work ERPIB. 

e Indicates that the ERPIB is for the inboard record only. 

e Passes control to the ERPIBSET routine to complete the ERPIB. 
e Sets the HIO displacement for return to the I/O supervisor. 


e Passes control to the UCB Search routine. 


routine 

the UCB address in the work ERPIB. 

to ensure that the channel is supported. 
general information in the ERPIB. 


control to the correct analysis module to complete the ERPIB (bypasses the 


analysis module for channel data checks, except on the 2880 channel). 
e Examines the bits set by the analysis module and sets appropriate flags. 


e Moves the ERPIB to the ERPIB table and to the inboard record or to the inboard 


only. 


e Returns control to the correct interception-dependent routine. 


c 


U 


c 


C 


UCB Search routine 


Completes the inboard record with up to eight addresses of active units on the 
failing channel. 


If system termination is indicated, returns to IGFVCCHC, if necessary to complete 
an inboard record. Passes control to MCH. 


If system termination is not indicated, passes control to the I/O supervisor. 


2 


fesse Ss a aes is ME fee ee 
{ Entry Point | Entered From | Exits To 
Ee eoeyee eee ee ree Hee ie ee Se eee ee ee eee 
| IGFVCCHC | 12/0 supervisor | Machine-Check Handler via a branch to the address 
| | | contained in RVTSHUT if a system termination con- 
| | | dition exists. 
| ( | 
| | | I/O supervisor via register 14 if a system ter- 
| | | mination condition does not exist. 
CS aS Be a ee eo a Ss sk oon ic cr 
aa i ian aaa A aS A a eg a a areca 
| IGFVCCc60 - CCH 2860 Channel Error Analysis 
Sea So ee a oe ee ee SS = Se a ee ee ee 
| « Indicates system termination if the logout is not complete. 
| 
| « Examines combinations of bits set in the channel logout and then sets bits in the 
| work ERPIB to indicate: 
| 
| Validity of the unit address, device status, channel program address, and count. 
| 
| Source of error. 
| 
| Termination code. 
| 
| Sequence code. 
| 
| « Moves the channel logout to the inboard record. 
| 
| « Sets the logout area to 1's. 
| 
| « Puts the record length in the inboard record count field. 
| 
iia a Te sre Wa ea Ge Se a ee Ce a ee 
| Entry Point | Entered From | Exits To 
|------------~---------------- }----------------------------- }--------------------------- 
| IGFVCC60 | IGFVCCHC | IGFVCCHC 
| | (ERPIBSET) | (ERPIBSET) 
ER agen fs ene ee eee ema oR Ren ee ne ee a eit a res oe I ican ie ee 
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po Sa SS a Ss ee ee eee eee nese ete ea essa enon fo ee no aa asa eee es 
| IGFVCC70 - CCH 2870 Channel Error Analysis 

r a ate a a Ie a es 
| « Indicates system termination if the logout is not complete. 

| 

| © Examines combinations of bits set in the channel logout and then sets bits in the 

| work ERPIB to indicate: 

| 

| Validity of the unit address, device status, channel program address, and count. 

| 

| Source of error. 

| 

| Termination code. 

| Sequence code. 

| 

{ * Moves the channel logout to the inboard record. 

| 

| © Sets the logout area to i's. 

| 

| *« Puts the record length in the inboard record count field. 

| 

poSsss sss === =s45 Se a Pe ee ee Re Aone ge ee ee 
| Entry Point { Entered From | Exits To 
|---------------------------- }---------------~------------- }---------------------------- 
| IGFVCC70 | IGFVCCHC | IGFVCCHC 

| | (ERPIBSET) | (ERPIBSET) 

bee ee ee ee sie eee eee Bee Soe ee eel 
an a ama a a da Ra Tg a a a 
| IGFVCc80 - CCH 2880 Channel Error Analysis 

I a a a ee ee ee ee 
{| e Indicates system termination if the logout is not complete. 

| 

| © Examines combinations of bits set in the channel logout and then sets bits in the 

| work ERPIB to indicate: 

| 

| Validity of the sequence code, unit address, device status, and channel program 

| address. 

| Source of error. 

{ 

| Termination code. 

| 

| Sequence code. 

| 

| « Moves the channel logout to the inboard record. 

| 

| e Sets the logout area to 1's. 

| 

| e Puts the record length in the inboard record count field. 

| 

a a a Ne ee ee Dg ee ie ie ee ee 
| Entry Point | Entered From | Exits To 
|---------------------------- $-~--------------------------- 4$-----------~+---------------- 
| IGFVCC80 | IGFVCCHC | IGFVCCHC 

| | (ERPIBSET) | (ERPIBSET) 

eee ee Se ae eee Se gee en ers eee enya ayer Mees Se eee eee ee 
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ee ee ee | 


a ne 


C 


Fg en re er pp ete ea Sh eg en ee tee es ee ee tee ee ee 1 
| IGFVCC35 - CCH 135 Channel Error Analysis | 
|--------------------------------------------------------------------------------------- : 
| , sea , 
| e Indicates system termination if the ECSW is not complete. | 
| | 
{| #« Moves the last three bytes of the ECSW to the last three bytes of the work ERPIB. | 
| 
| * Moves the hardware-stored unit address to the inkoard record. | 
| | 
| © Moves the channel logout to the inboard record. | 
| 
| «© Sets the logout area and the first byte of the ECSW to 1's. | 
| | 
| «© Puts the record length in the inboard record count field. | 
| | 
a eS Te eee Re ee ee Poe sere sae ee as ey { 
| Entry Point | Entered From | Exits To | 
|---------------------------- }----------------------------- }---------------------------- { 
| IGFVCC35 IGFVCCHC | IGFVCCHC | 
| | (ERPIBSET) | (ERPIBSET) | 
bee aa a Se ee eS eae ee eed 
ee ee eee eee eT ie Tee Vig ete ef ee Os Pe Te ee RO er ee a ee ey eee 1 
| IGFVCC4H5 - CCH 145 Channel Error Analysis | 
De ootcte cue ue dh cke. | TCS 
| * Indicates system termination if the ECSW is not complete. | 
| | 
| e« Moves the last three bytes of the ECSW to the last three bytes of the work ERPIB. | 
| | 
| #« Moves the hardware-stored unit address to the inkoard record. | 
| | 
| ¢ Moves the channel logout to the inboard record. | 
| 
| e« Sets the logout area and the first byte of the ECSW to i's. | 
| 
| « Puts the record length in the inboard record count field. { 
| | 
|---------------------------- qo nano nn -- 2-22 === === == y~--------------------------- { 
| Entry Point | Entered From | Exits To | 
|--------~------------------- {----------------------------- }---------------------------- { 
| IGFVCC45 | IGFVCCHC | IGFVCCHC | 
| | (ERPIBSFT) | (ERPIBSET) | 
ee ney ena, yee De ee ee a ae ee ee J 
fa pape Ser eee a a Ee eee a ee ee an a ee eae a eS a 1 
| IGFVCC55 - CCH 1551I/158 Channel Error Analysis | 
Be ee en, to as ens oe a I a 
| « Indicates system termination if the ECSW is not complete. | 
| | 
| « Moves the last three bytes of the ECSW to the last three bytes of the work ERPIB. | 
| 
| «© Moves the hardware-stored unit address to the inkoard record. | 
| | 
| e Sets the first byte of the ECSW to 1's. | 
| | 
| « Puts the record length in the inboard record count field. | 
| | 
| Note: Also provides minimum support for unrecognized channels. | 
| | 
a a a cg et a a a i ala Dap re er Sn oe ee = 
| Entry Point | Entered From | Exits To [ 
}---------------------------- }----------------------------- 4---------------------------- { 
| IGFVcCc55 | IGFVCCHC | IGFVCCHC | 
| | (ERPIBSET) | (ERPIBSET) | 
(seo ee es Soe oS TG Sp pe ee ep ee mee a eae Mae Se a ek ~ 
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CCH SECTION 4: 





DIRECTORY 


The directory provides a quick reference 
from this publication to the pertinent cod- 
ing, or from the coding back into the pub- 


lication. 
lowing information: 


Module and CSECT Name: 
object module 
ing indicated 


Label: 


entry points, 
ing, and data 
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IGFVCCHC 


The directory contains the fol- 


Names 


+———— —— — — — — — — —— — — — — + - -— — 


——+—— 4+ —— — 4+ — — 


-—+——+ 


The name of the 
and CSECT containing the cod- 
by the label. 


taken from the listing for 
Significant sections of cod- 
areas. 


CHANSUPT 
GETRESIZ 
STOREID 


= 
| 

| 
+ 
| 

| 

| 
+ 
CCHCNTU | 
CCHGETRG | 
CCHHIO | 
CCHINT | 
CCHMOVE | 
CCHQUIT | 
CCHSETFL | 
| 

| 

| 

| 

| 

| 

| 

| 

| 

| 

+ 

| 

| 

| 

+ 


Nucleus 


CCHSTO 
CCHSNS 
CCHSSK 
CCHT IOSK 
CCHTIOSN 
CcH000 
CCH007 
CCH101 
CCH102 
CON80 
UCBSCH 


CCHRETRN 
CCH02860 
CCH029A 
CCHRETRN 
CCH0 2870 
CCHO029A 
CCHLOGOK 
TESTRESW 


CCH35 
MOVELOG 


-—4-—— + —— 4+. — — 4+ — — — 4+ — — — 4+ YH 


Library: 


Name: 
to the module. 





Diagram: 


The place where the module 
resides kefore initialization. 


The descriptive name used to refer 


The method of operation diagram 


containing information about the coding 


identified by the label. 
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CCH SECTION 5: DATA AREAS 


This section contains descriptions of the principal data areas used by 
CCH: 


e Channel-~Check Handler parameter table 
e Error recovery procedure interface block (ERPIB) 
e Channel error inkoard record 


The symbolic names shown in individual fields represent the displace- 
ment, in bytes, from the beginning of a specific data area to the field. 
Access is gained to a specific field by using an instruction in which the 
beginning address of the area (usually contained ina register) is the 
base address, and the symbolic field name represents the displacement. 
Use of the fields can be traced in the CCH listings by first locating the 
symbolic field names in the cross-reference takle at the back of the 
listings and then noting where the names are used. 


The field headings and their meanings are: 
Displacement: The numeric address of the field relative to the beginning 


of the data area. The first number is in decimal; the second (in paren- 
theses) is the hexadecimal equivalent. 


Bytes and Bit Patterns: The size (number of bytes) of the field and the 
bit settings of flag fields; that is, the state of bits ina byte. When 
the column is used to show the state of kits, it is shown as follows: 
eeee oeee- The eight bit positions (0-7) ina byte. For ease of scan- 
ning, the high-order (left-hand) four bits are separated 
from the low-order four Lits. 
1... «2-. A reference to bit O. 
ecee «eXX Bits 6 and 7 are reserved. 


Bit settings that are significant are shown and described. Bit settings 
that are not presently Significant are described as reserved bits. 


Field Name: A name that identifies the field. 
Field Description: The use of the field. 
Figure CCH-12 is provided to assist in locating CCH fields. This 


figure contains an alphabetic list of the fields with their 
displacements. 
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| Field Name 


_- 
! 
| 
! 
! 
! 
| 
! 
! 
| 
{ 
' 
! 
! 
! 
1 


CCHANTAB 
CCHBASE 
CCHCFGWD 
CCHPTTAB 
CHANID 
CHNLOG 
COUNT 
CPUIDFD 
CSWLWB 
CUADDR 
DEVTP 
ECSW 
ERPIBAD 
FAILCCW 
FLAG 
IGBLAME 
IGPRGLFG 
IGTERMSQ 
IGVALIDB 
IGUCB 
JOBID 
KEY 
RECORD1 
RELENGTH 
SWITCHES 
TIME 
TIOADDR 


Figure CCH~-12. 
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CHANNEL-CHECK HANDLER PARAMETER TABLE 


This data area is located in the first five words of the IORMSCOM 
(input/output recovery management support communications area). Its use 
in the Channel-Check Handler communications scheme is illustrated in 
Figure CCH-11. 


Bytes and 
Displacement Bit Patterns Field Name Field Description 

0 (0) 20 CCHPTTAB 

0 (0) 4 ERPIBAD Address of error recovery pro- 
cedure interface block table. 

4 (4) 1 FLAG Flag indicating if there are 
any inboard records to be 
written. 

5 (5) 3 RECORD1 Address of inboard record 
area. 

8 (8) 4 CCHBASE CCH base register value. 

12 (C) 4 CCHANTAB Address of CCH channel error 
analysis routine pointer 
takle. 

16 (10) 4 CCHCFGWD Address of channel configura- 


tion word. 
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ERROR RECOVERY PROCEDURE INTERFACE BLOCK 


The ERPIB (error recovery procedure interface block) is the eight-byte 
field in which CCH places the results of its analysis of the channel 
error for use by the appropriate ERP. 


Bytes and 
Displacement Bit Patterns Field Name Field Description 
0 (0) 1 Reserved. 
1 (1) 3 IGUCB Address of the unit control 


block for the device in use 
when the channel failure 
occurred. The ERP uses this 
address to locate the correct 
ERPIB for the current error. 
y (4) 1 IGPRGLFG Program flags. Indicates the 
selection or interruption 
sequence when the CSW was 


stored: 

graces caeeete CSW was stored after a Start 
I/O instruction was executed. 

cise. aieace CSW was stored after an I/0 
interruption. 

ieee tears CSW was stored after a Test 
I/O instruction was executed. 

oa eae CSW was stored after a Halt 
I/O instruction was executed. 

wees, ~Sclvere Sense data was stored. 

dasa Aaa ds Count in CSW is valid. 

aouiee. ere e No retry is to be attempted 
under any conditions. 

Sica eten eres Reserved. 

5 (5) 1 IGBLAME Probable source of error. The 


determination is made by the 
channel on the basis of the 
type of error check, the loca- 
tion of the checking station, 
the information flow path, and 
the success or failure of 
transmission through previous 
check stations. 


Normally, only one bit is 
set in this field. However, 
when communication cannot be 
resolved to a single unit, 
such as when the interface 
between units is at fault, 
multiple bits (normally two) 
may be set in this field. 
When a reasonable determina- 
tion cannot be made, all bits 
in this field are set to 0. 


If the detect and source 
fields indicate different 
units, the interface between 
them can also be considered 


suspect. 
Dect) a ae CPU error. 
ae Pe Channel error. 
Stee. Soeece Storage control unit error. 
ool saoe storage error. 
oe obs saree Control unit error. 


See See Reserved. 


Displacement 


( 6 (6) 


7 (7) 


Bytes and 


Bit Patterns 


1 


Lees eeeese 
owed @eeees 
@eeeses Paid 


@eees Ses 


ee ae ee 


@eeeese ae bi 


eXXo eeees 


et eens eeees 


o oe XX eaee#ees 


e@ee#ee Tice vets 


@e@es @ eld 


Field Nare 


IGVALIDB 


IGTERMSQ 


Field Description 
Validity indicators. When the 


designated field is stored by 
the channel with the correct 
contents, the validity bit is 
1. When the designated field 
is stored by the channel with 
unpredictable contents, the 
validity bit is 0. The vali- 
dity bits for nonstored fields 
are meaningless. 

Interface address is valid. 
Sequence code is valid. 

Unit status is valid. 

Command address is valid. The 
CSW contains a valid command 
address. 
Channel address is valid. 
Device address is valid. 
Reserved. 
Termination and sequence 
(retry) codes: 
Termination code. Specifies 
the termination Signals used 
on the I/O interface after the 
channel detected the error. 
This field has meaning only 
when a channel control check 
or an interface control check 
1s indicated in the CSW. When 
neither of these is indicated, 
no termination has been forced 
by the channel. 

00 Interface disconnect. 

01 Stop, stack, or normal 

termination. 

10 Selective reset. 

11 System reset. 
Reserved. 
I/O error alert. The indi- 
cated unit has signaled the 
I/O error on the I/O inter- 
face. The channel performs a 
selective reset and causes an 
interface control check to be 
set in the CSW. 
Sequence code. The sequence 
codes have different meanings 
for the stand-alone and inte- 
grated channels, as follows: 


For 2860, 2870, and 2880 chan- 
nels: Indicates when the 


channel detected the error. 
Meaningful only for channel 
control checks or interface 
control checks. Not to be 
used by error routines 
involved with unit checks. 


000 The error occurred during 
execution of a Test I/0 
instruction. A pending 
interruption in the chan- 
nel may have been 
cleared. 
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Bytes and 
Displacement Bit Patterns Field Name Field Description 

7 (7) (Continued) IGTERMSQ 001 The channel has sent a 
Command Out signal but 
has not yet examined the 
unit status. May indic- 
ate unpredictable move- 
ment on devices with con- 
trol units that start 
movement at the Command 
Out Signal. 


010 The device accepted the 
command but no data was 
transferred. Magnetic tape 
devices do not begin tape 
motion for a write operation 
until the first byte of 
data has been transferred. 


011 At least one byte of data 
was transferred over the 
interface. The command 
address in the CSW is 
eight bytes higher than 
the address of the com- 
mand causing the data 
transfer. In general 
this means device move- 
ment may have taken place 
if an Interface Discon- 
nect signal was issued. 


100 The command was not 
accepted by the control 
unit, or a Command Out 
Signal has not been sent 
to the control unit for 
the command at the 
address eight bytes high- 
er than the address in 
the CSW. No device move- 
ment has taken place. 


101 The command was accepted 
but data transfer may not 
have taken place. If the 
termination code is 
"interface disconnect," 
activity can be retried 
on most devices. It cannot 
be retried if the command 
was a Write command for a 
magnetic tape device. 


110 Reserved. 


111 No other codes apply. If 
any other sequence codes 
are retryable, this code 
is retryable. 


For 135, 145, and 155II chan- 
nels: Identifies the I/0 


sequence in progress at the 
time of the error. It is 
meaningless if stored during 
the execution of Halt I/O or 
Halt Device. 


c 


Displacement 
7 (7) 


Bytes and 


Bit Patterns 


(Continued) 


Field Nare 


IGTERMSQ 


Field Description 
For all cases, the channel 


program address, if validly 
stored and nonzero, is the 
address of the current CCW+8. 


When a Test I/O is issued 
to a channel with a pending 
channel logout condition, the 
Test I/O causes the channel to 
store a CSW, perform a logout, 
and reset the condition without 
regard for the device address 
associated with the Test I/O. 
The I/O address that pertains 
to the logout condition is 
stored in locations 185-187. 


A logout resulting from an 
error that occurred during the 
execution of a Test I/0 
instruction can be differen- 
tiated from a logout cleared 
by a Test I/O by examining the 
sequence code, because 
sequence code 0 can only occur 
in the first situation. 


000 A channel-detected error 
occurred during the 
execution of a Test I/0 
instruction. 


001 Command Out with a non- 
zero command byte on Bus 
Out has been sent by the 
channel, but device sta- 
tus has not yet been ana- 
lyzed by the channel. 
This code is set with a 
Command Out response to 
Address In during initial 
selection. 


010 The command has been 
accepted by the device, 
but no data has been 
transferred. This code 
is set by a Service Out 
or Command Out response 
to Status In during an 
initial selection 
sequence, if the status 
is either channel end 
alone, or channel end and 
device end, or channel 
end, device end, and sta- 
tus modifier, or all O‘s. 


011 At least one byte of data 
has been transferred Over 
the interface. This code 
is set with a Service Out 
response to Service In 
and, when appropriate, 
may be used when the 
channel is in an idle or 
polling state. 
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Displacement 
7 (7) 


Bytes and 


Bit Patterns 


(Continued) 


Field Narre 


IGTERMSQ 


Field Description 


100 


101 


110 


111 


The command in the cur- 
rent CCW has either not 
yet keen sent to the 

device or else was sent 
but not accepted by the 
device. This code is set 
when one of the following 
occurs: 


e When the command 
address is updated dur- 
ing command chaining or 
a Start I/O. 

e When Service Out or 
Command Out is raised 
in response to Status 
In during an initial 
selection sequence with 
the status on Bus In 
including attention, 
control unit end, unit 
check, unit exception, 
busy, status modifier, 
(without channel end 
and device end) or 
device end (without 
channel end). 

e When a short, control- 
unit-busy sequence is 
Signaled. 

e When command retry is 
signaled. 

* When the channel issues 
a Test I/O command 
rather than the command 
in the current CCW. 


The command has been 
accepted, but data 
transfer is unpredict- 
able. This code applies 
from the time a device 
comes on the interface 
until the time it is 
determined that a new 
Sequence code applies. 
It may thus be used when 
a channel goes into the 
polling or idle state and 
it is impossible to 
determine that code 2 or 
3 applies. It may also 
be used at other times 
when a channel cannot 
distinguish between codes 
2 and 3. 


Reserved. 


Reserved. 


CHANNEL ERROR INBOARD RECORD 


The inboard record is the place where CCH stores information about the 
channel error to be written into the SYS1.LOGREC data set for use by the 
Operator and system maintenance fersonnel. 


Bytes and 


Bit Patterns Field Name 


Displacement Field Description 


0 (0) 
6 (6) 


8 (8) 


10 (OA) 


10 (0A) 


11 (0B) 


12 (0C) 


16 (10) 


24 (18) 


32 (20) 


4Q (28) 


56 (30) 


64 (40) 


72 (48) 


76 (4c) 


80 (50) 


] Ree 
me eon 


red Ee 
ooe kX 


1... 
e1.. 
eel. 
ecel 


6 


2 


2 


XXXX 


XXXX 


16 


COUNT 
RELENGTH 


KEY 


SWITCHES 


SWBYTEO 


SWBYTE1 


TIME 


CPUIDFD 


JOBID 


ACT IO 


FAILCCW 


CSWLWB 


ECSW 


DEVTP 


CHANID 


Count information for the Out- 
board Recorder. 

Record length. The length of 
the record minus 10 bytes. 
Record ID. The first byte 
contains X"'20° to identify the 
record as CCH inboard record. 
The second byte contains: 


Bits 0,1,2 -- 000=O0S system 
010=-OS/VS system 
3-7 -- release level 
(binary) 


Operator action message. 
System/370 machine - date and 
time from System/370 clock. 
EC mode. 

Reserved. 


Message required. 

Record incomplete. 

CCH terminated system. 

Channel not supported. 
Reserved. 

Reserved. 

Time and date record was made, 
from STORE CLOCK instruction. 
Model and serial numbers of 
the CPU on which the error 
occurred. 

Name of the job being executed 
when the failure occurred. 
Addresses of I/O devices 
active at the time of the fai- 
lure on the failing channel 
(maximum of eight). 

Failing CCW. The last real 
CCW executed before the 
failure. 

Contents of the CSW stored at 
the time of the failure. 

The last four bytes of the 
ERPIB. For the 135, 145, and 
155II channels, the last three 
bytes of the ERPIB are equiva- 
lent to the last three bytes 
of the extended channel status 
word. 

The device type, taken from 
the UCB for the failing 
device. 

Channel type ID taken from the 
channel configuration word 
(produced during system 
generation). 
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Displacement 
81 (51) 


84 (54) 
88 (58) 


92 (5C) 


Bytes and 


Bit Patterns 
3 


a 


Variable 
length 


Field Name 


CUADDR 


TIOADDR 


CHNLOG 


Field Description 
Address of the channel and 


unit being used when the fai- 
lure occurred. For a 2314, 
the address is the one ini- 
tially associated with the 
cell experiencing the error. 
Reserved. 

Unit address as stored by com- 
puter in location 184. See 
"Note" for field CHNLOG. 
Logout information sent by the 
channel. The length of this 
field varies with the type of 
channel: 


Channel Length 
[Se Ag ee ee 1 
| 2860 | 24 bytes | 
}-----~----- +-------------- : 
| 2870 | 24 bytes | 
a a aia a : eae araER GE 1 
| 2880 | 112 bytes | 
carga SRE aaa 1 Sea TR aa Rens | 
| 135 | 24 bytes | 
}----------- +~------------- ! 
} 145 | 96 bytes | 
|----------- ¢-------------- : 
| 155I1/158 | 0 bytes | 
eae ene ae ere Deo soo J 


Notes For the 2860, 2870, and 
2880 channels, there is no 
TIOADDR field in the inboard 
record; the CHNLOG field 
therefore begins at displace- 
ment 88 for those three 
channels. 





C 


C 


This section contains information to aid in locating errors in CCH. 








CCH SECTION 6: 


Figure 


CCH-13 shows the contents of the general purpose registers expected upon entry tc 
Figure CCH-14 shows the internal switches (or flags) used by 
CCH and discussed in other parts of this book. 


each CCH module. 










LOGBASE 
WRK4 





IBREG 











WKERPIB 






CVTREG 
WKREGO 
WORK5 
WORKREG9 










LOGPTR 
RES ZREG 
WKREG2 


















WORKREGB 
MOVEREG 12 
R12 
WKREG3 
WORKREGC 

13 


LINKREG1 
R14 
WORK4 


















Return to NIP 
























Return to I/O 


Supervisor 


Base Address 
for 
WORK ERPIB 
and 


SWITCHES 


CVT Address 


Inboard 
Record 
Address 


Register Input Expected by Each CCH Module 
Registet Register | Gevecin | iorFvccHc | IGFVcc60 | IGFVCC70 
Name Number 


INDEX Address of 
RVTREG Parameter co" ae 


RTNADRG Base Address 
WORK3 


Base Address 


CUAREG Unit Address Unit Address Unit Address Unit Address Unit Address Unit Address 
UAREG 
UCBREG Be Address 

(or 0) 


Base Address 
for 
WORK ERPIB 
and 


SWITCHES 


CVT Address 





LINKREG? Return to Return to 
WKREG 1 IGFVCCHC IGFVCCHC 


Inboard 
Record 
Address 









IGFVCC80 IGFVCC45 


IGFVCC55 
Base Address Base Address 





Base Address 








Base Address Base Address 





Base Address 












for for for 
WORKERPIB WORKERPIB W ORKERPIB 
and and and 


SWITCHES SWITCHES SWITCHES 





















CVT Address 










Return to 
IGFVCCHC 


Return to 
IGFVCCHC 


Return to 
IGFVCCHC 








Inboard Inboard Inboard 
Record Record Record 
Address Address Address 





( Figure CCH-13. Register input expected by the modules of CCH 
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The internal switches used by CCH follow the WORKERPIB in the code of IGFVCCHC. 


Valid parity in 2860 logword IGFVCC60 IGFVCCHC IGFVCC60 
(Initial Entry) 


for command register. 

IGFVCCHC IGFVCCHC IGFVCCHC (all 
(Initial Entry) (Initial Entry) interception-dependent 

routines except 

CCHHIO; ERPIBSET; 
UCBSCH) 
IGFVCC60 
IGFVCC70 







Name Equated To Meaning 












CCHCMDRG 


Command register 
parity valid 

































CCHNORE 


There js no inboard record 
available to record this error. 


No inboard record 
available 


















































IGFVCCHC 
(Initial Entry) 


An ERPIB has been freed for 
use. This occurs when it is 
necessary to search ERRLCH 
and the SIRB to free an ERPIB. 


IGFVCCHC 
(Initial Entry) 


IGFVCCHC 
(Initial Entry) 


CCHERFRE ERPIB freed from 


active list 

















IGFVCCHC 
(Initial Entry) 


IGFVCCHC 
(ERPIBSET) 


CCHNOLST The completed ERPIB is not to IGFVCCHC (CCHHIO; 
be moved to the ERPIB Table CCHSNS; Initial Entry; 
to be passed to the ERP. The ERPIBSET) 

ERP|IB has been created for use| IGFVCC60 

only in the inboard record. IGFVCC70 


IGFVCC80 


Inboard record only- 
no ERPIB to list 




















CCHHAND 





Device end or Recovery is allowed on IGFVCCHC 
attention presented asynchronous device ends and (Initial Entry) 
attentions. 


IGFVCCHC IGFVCCHC 
(Initial Entry) (CCHINT) 



























CCHIBC IGFVCCHC 


(Initial Entry) 


IGFVCCHC 
(Initial Entry) 


IGFVCCHC 
(CCHSNS) 


The device-in-error had a 
previous channel error, and 
an ERPIB has already been 

created. 


ERPIB already created 


























UCBNVBIT UCB invalid IGFVCCHC 


(Initial Entry; ERPIBSET) 


IGFVCCHC 
(Initial Entry) 


IGFVCCHC 
(Initial Entry; CCHINT) 





No UCB address was passed 
to IGFVCCHC by IOS. 






















































SYSTERM Signal for system Upon completion of the IGFVCCHC (ERPIBSET) IGFVCCHC IGFVCCHC (Initial 
termination inboard record, give control IGFVCC60 (Initial Entry, Entry; ERPIBSET; 
to the Machine-Check IGFVCC70 UCBSCH) UCBSCH) 
Handler to record the inboard IGFVCC80 
record and place the system in 
the wait state. 
INTRN2 X'40' Alternate return IGFVCCHC (ERPIBSET) IGFVCCHC IGFVCCHC 












NOMODEL X'20' IGFVCC80 


No model found for 
logout 


IGFVCCHC IGFVCCHC (ERPIBSET) 
(Initial Entry) IGFVCC80 
IGFVCC80 
























NOLOG The 2860 channel error IGFVCC60 


analysis routine has set the 
SYSTERM switch because the 
2860 logout area indicated 
that no log is present. 
Therefore, this might not have 
been a 2860 channel logging 
out, but a 2880 operating as a 
selector channe!. 


IGFVCCHC 
(Initial Entry) 
IGFVCC80 


IGFVCCHC 
(ERPIBSET) 
IGFVCC80 


No channel! logout 














Figure CCH-14. CCH internal switches 
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PART 3: 


DYNAMIC DEVICE RECONFIGURATION 
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PURPOSE OF DDR 


DDR (Dynamic Device Reconfiguration) 
enables the system to attempt to bypass the 
source of various I/O errors by allowing a 
demountable volume to be moved from one 
device to another. A request to move (or 
Swap) a volume may be initiated by either 
the system or the operator. 


DESCRIPTION OF DDR 


DDR is a Standard feature of OS/VS. DDR 
Operates under its own task control block 
and has its own request queue element, I/0 
block, data control block, data extent 
block, channel end appendage, and abnormal 
end appendage. It is executed in the 
supervisor state. 


The system requests DDR after a per- 
manent I/O error has occurred. The opera- 
tor may request DDR at any time by issuing 
the SWAP command. 


A swap involves two exchanges: the 
exchange of information between the UCBs 
(unit control biocks) for the two devices 
and the physical exchange of the volume 
from one device to another. The exchange 
of UCB information is performed by DDR 
uSing SVC 15. The operator is then 
requested by DDR to move the volume to the 
new device. 


DDR SUPPORT 


Volumes can only be swapped between 
devices of the same type; for example, a 
volume can be moved from one 2314 drive 
(the FROM device) to another 2314 drive 
(the TO device). Only the following 
devices are supported: 


e Direct access devices: 
3330, 3330-1 and 3340. 


2314, 2319, 


e Tape drives: 2400 series and 3400 
(2400 equivalent) series. 


e Unit-record devices: 1403 printer, 
1404 printer, 1442 card read punch, 
2501 card reader, 2520 card read punch, 
2540 card reader, 2540 card punch, and 
3211 printer, 3505 card reader, and 
3525 card punch. 
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A volume can be moved from one device to 
another, or a volume can be swapped to 
itself. A volume is swapped to itself if: 


e The volume demounted and then remounted 
on the same device. 


e Or, in the case of a 2314, 2319, 3330, 
3330-1, or 3340, both the volume and 
the address plug are moved to another 
drive. 


Other DDR restrictions include the 
following: 


e Teleprocessing devices are not 
supported. 


e Emulator 7-track tapes in original, 
second generation, format are not 
supported. 


e The system residence volume cannot be 
specified as the TO device. 


e Swap requests for unit-record devices 
can only be initiated by the operator 
and then only during intervention- 
required conditions. 


e A shared volume can only be swapped to 
itself. 


e Tape volumes can be swapped only if the 
following conditions are met: 


e The swap is between tapes with the 
Same number of tracks and the same 
densities (for example, 9-track 800 
BPI to 9-track 800 BPI). 


e If the tape does not have standard 
labels, the user must supply a pro- 
gram to reposition it after the swap. 

e The block count cannot equal 0. 

e The user is keeping an accurate block 
count, when the EXCP macro instruc- 
tion is being used. 


e The TO device is not allocated. 


e An OPEN, CLOSE, or EOV must not be 
active for a device involved in a Swap. 


e An SVC DUMP must not be active for a 
device involved in a swap. 


e A permanently resident volume cannot be 


swapped. 
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In addition to the above restrictions, 
DDR processes system-initiated swaps for 
only these conditions: 


e A unit check with one of the following 
indicated in the sense information: 
bus-out, equipment check, data check, 
overrun, seek check, unsafe, ALU check, 
unselected status, read safety, end of 
cylinder, seek incomplete, or any con- 
dition indicated in the data check 
field. 


e One of the following indicated in the 
channel status word: channel data 
check, channel control check, interface 
control check, or chaining check. 


When a permanent error is caused by the 
channel program (such as command reject), 
DDR iS not requested by the system. Other 
conditions that may set permanent I/O error 
status, but that are not eligible for DDR, 
include: wrong length record, no record 
found, unit exception, program check, pro- 
tection check, IOB intercept condition, and 
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backing into load point on tape. Also, for 
tape, a SWAP occurs if "INTERVENTION REQ" 
or "NOT READY" status exists. 


J 


GENERATING DDR 


The exact configuration of DDR depends 
upon the options specified during system 
generation. Unless otherwise specified, 
DDR is included in VS1. It is always r 
included in VS2. For VSi, DDR is generated 
to execute swap requests for the system 
residence volume (SYSRES) unless otherwise 
specified. DDR under VS2 does not support > 
Swap requests for SYSRES. 


If DDR is to process tapes that do not 
have standard labels, DDRNSL must be speci- 
fied in the OPTIONS parameter of the 
CTRLPROG macro instruction, and the user 
rust provide a routine to verify the tape 
labels. See "Repositioning Tapes without 
Standard Labels" in DDR Section 2 for 
details. 


c 


This section descrikes the functions of 
DDR and how DDR performs these functions. 
Many references are provided to material in 
other sections of this publication and to 
the DDR program listing. Two types of 
information are presented: 


e Text that discusses the design of DDR. 


e Method of operation diagrams that show 
the functions performed by DDR in the 
order that they occur. The module name 
and label of each processing step are 
included in the implementation notes 
for each diagram. These diagrams can 
be used for quick reference when 
reviewing DDR functions. Diagram DDR-1 
shows how the method of operation dia- 
grams for DDR are organized. 


OVERALL OPERATION 


DDR performs three major functions when 
processing a Swap request: 


e Verifies the request. 
e Controls the execution of the request. 
e Executes the request. 

DDR Verification 


The verification routines first receive 
control when a DDR request is initated. 
The request can be initiated either by the 
system, if a permanent I/O error is encoun- 
tered, or by the operator. DDR verifies 
the request and then initiates DDR execu- 
tion by posting the event control block for 
DDR. Diagram DDR-2 shows how DDR requests 
are verified and how execution is initiated 
for system-initiated swaps. Diagram DDR-3 
shows the same operations for operator- 
initiated swaps. 


DDR Control 


The control routines route control to 
the routines that process a DDR request and 
that terminate DDR execution. Diagram 
DDR-4 shows how DDR controls both system- 
initiated and operator-initiated swap 
requests. 


DDR Execution 
The execution routines are those rou- 


tines that process a DDR request. The DDR 
execution routines: 
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e Gain control of the devices involved in 
the swap. 


e Swap UCB information. 


e Request and monitor the exchange of the 
volumes. 


Diagram CDR-5 shows the execution of 
operator-initiated swaps (except for 
SYSRES). Diagram DDR-6 shows the execution 
of system-initiated swaps (except for 
SYSRES). Diagram DDR-7 shows the execution 
of a swap (both operator- and systen- 
initiated) involving SYSRES. 


DDR COMMUNICATIONS AREA 


A data area (IORMSCOM) is used to main- 
tain communications between the routines 
that make up DDR and to establish inter- 
faces between DDR and other parts of the 
operating system. IORMSCOM contains the 
addresses of pertinent control blocks and 
information about the status of DDR. A 
detailed description of IORMSCOM can be 
found in DDR Section 5. 


ACTIVATING DDR 


ECB for DDR 


The DDR Resident routine (IGFDDRMF for 
VS1, IGFDDRMV for VS2) resides in the nuc- 
leus. If DDR is not processing a DDR re- 
quest, this routine waits on DDRECB. 

CDDRECB is the ECB (in IORMSCOM) that is 
posted by one of the DDR verification rou- 
tines IGE0660A or IGF2503D) to initiate the 
processing of a verified DDR request. 


DDR Control Flow 


If a DDR request iS operator-initiated, 
the SWAP command is passed to the SWAP Com- 
Wand Processor (IGC2503D) by the system 
Command Router (IGC0O403D). IGC2503D veri- 
fies the command and, if the request can be 
processed, posts DDRECB. 


If DDR is initiated by the system, the 
Outboard Recorder (OBR) passes control to 
DDR Central (IGE0Q660A). IGEQ660A verifies 
the request. If the request is valid, the 
RQE associated with the request is placed 
on the DDR wait queue, and CDRECB is 
posted. 


The above discussion does not afrly to 
the VS1 system residence volume. If the 
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Swap request for SYSRES is operator- 
initiated, DDR processes it as any other 
other operator-initiated request until 
IGCO108E gains control. Upon determining 
that the request is for SYSRES, IGC0O108E 
returns control to IGFDDRMF. IGFDDRMF then 
branches to IGFDDRSR to process the 
request. 


The system initiates a DDR request for 
SYSRES as follows. Each time a permanent 
error is encountered involving a fetch from 
SYS1.SVCLIB, the disk ERP IEC23xxF (error 
recovery procedure) branches to IGFDDRO5 
(in IGFDDRSR). After five unsuccessful 
attempts by the system to fetch a module 
from SYS1.SVCLIB, IGFDDRO5 determines 
whether DDR is to handle the error, and 
then sets a return code and exits to the 
disk ERP. If DDR is to handle the error, 
the disk ERP returns control to IOS to post 
the error and to gain control of SYSRES for 
DDR. Control is then returned to IGFDDRSR 
to process the request. Figure DDR-1 illu- 
strates this procedure. 


SVC 85 


When DDRECB is posted, module IGFDDRMF/ 
MV issues SVC 85 to start processing the 
Swap request. SVC 85 consists of 10 loads 
(modules IGCOOQOQ8E - IGCO908E). For VS1, 
these modules reside in SYS1.SVCLIB; for 
VS2, these modules reside in SYS1.LPALIB. 


Each module of SVC 85 determines its 
Successor and uses SVC 7 (XCTL) to pass 
control to the next module. When SVC 85 
has completed execution, load 0 (IGCOO0O8E) 
issues SVC 3 to return control to 
IGFDDRMF/MV. 


DDR WAIT QUEUE 


A wait queue is used to hold requests 
for system-initiated swaps. (Operator- 
initiated requests cannot be queued; they 
are rejected if DDR is processing a re- 
quest). Since only one request can be pro- 
cessed at one time by DDR, system-initiated 
requests are queued until the current re- 
quest has been processed. The RQEs of 
failing operations are queued by IGEO660A. 
When DDR has completed processing one re- 
quest, it checks the wait queue for any 
waiting requests. 


Since RQES may be removed from the wait 
queue by the SVC purge routine of the I/0 
Supervisor, DDR checks the wait queue and 
the wait queue purge indicator at key 
points in its execution. If the RQE is no 
longer on the wait queue or if the purge 
bit is set, the RQE has been purged. DDR 
then stops processing that request and 
checks for another request on the queue. 
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CDR also checks to see that certain user 
control Elocks are still valid. 


INTERACTION WITH DEVICE ALLOCATION 


Because of a possible conflict between 
DDR and Device Allocation, from the time 
Device Allocation determines that a device 
is eligikle for allocation until it marks 
the device allocated, concurrent execution 
of DDR and Device Allocation is prevented, 
as follows: 


e Before Device Allocation can allocate a 
device, it issues a WAIT on ALLOCECB 
(an ECB in IORMSCOM). If DDR is not 
processing a request, ALLOCECB is post- 
ed, so that Device Allocation can 
proceed. 


e If Device Allocation is not being 
executed when DDR is activated, DDR 
marks ALLOCECB waiting. 


e If Device Allocation is being executed 
for a task not under TSO when CDR is 
activated, DDR sets the task 
nondispatchable. 


e If Device Allocation is being executed 
for a task under TSO, but TSO is not 
ready, DDR marks ALLOCECB waiting. 


e If Device Allocation is being executed 
for a task under TSO that is in real 
storage, DDR issues the TSEVENT macro 
instruction with a code of 45, causing 
the task to be swapped out. If the 
task is swapped back in before DDR has 
keen executed, the task is set 
nondispatchable. 


e If Device Allocation is being executed 
for a task under TSO that is not in 
real storage, DDR sets the TJBDDRND bit 
in the task's terminal job block. If 
the the task is swapped back in before 
DDR has been executed, the task is set 
nondispatchable. 


e After DDR has processed a request, it 
posts ALLOCECB and sets the task (if 
any) for which Device Allocation is 
being executed dispatchable. 


Note: TSO (time-sharing option) pertains 
only to VS2. 


I/O HANDLING -- JOS-DDR INTERFACE 


An IOS-DDR interface handles I/O for 
DDR. With its IOB error flags off, DDR 
uses its RQE to issue SVC 15. Control is 
passed to DDR‘s channel end appendage 
(IGFDDRO5 if DDR is being executed for 
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Method of Operation 


23 


DDR Section 


SYSRES, otherwise IGFVDDR2). Using a 
pointer (IOSVT in IORMSCOM) to the IOS-DDR 
vector table, and the proper displacement, 
the appendage branches to the part of I0S 
that performs the needed function. The 
appendage uses the DDR flags in IORMSCOM to 
determine the proper displacement; these 
flags are set by the DDR routine issuing 
svc 15. 


See “IOS-DDR Vector Table” in DDR Sec- 
tion 5 for a description of the vector 
table. 


EXCHANGING UCB INFORMATION 


When a volume is moved from one device 
to another, the device retains its UCB so 
that control blocks containing UCB 
addresses need not be changed. The UCB 
addresses for the two devices are switched 
in the address portion of the unit control 


BEFORE SWAP 


UCB Address List 





AFTER SWAP 


UCB Address List 


Notes: 1. 


UCB A 


UCB B 


UCB A 


The fields containing device information in the UCBs for devices 190 and 192 are exchanged. The UCB addresses for 


block look-up table. See Diagram DDR-5 for 
those fields that are exchanged in the UCB 
during a Swap. 


If the exchange is between logical chan- 
nels, any queued I/O requests for the 
volumes involved in the exchange are also 
interchanged so that they are on the 
correct logical channel. UCBNRY is set in 
both UCBs. Figure DDR-2 shows the results 
of DDR execution. 


REPOSITIONING TAPES WITHOUT STANDARD LABELS 


At the completion of a swap involving 
tape data sets, DDR attempts to verify and 
reposition the volumes. DDR processes swap 
requests only for tapes with standard 
labels or no labels, unless the user pro- 
vides his own routine to verify and reposi- 
tion tapes that do not have standard 
lakels. 


Device 190 


4 Device 190 


Volume 


@ 


A Device 192 Device 192 


Volume 


@ 







Device 190 


A Device 192 


Volume 


@ 


Device 192 


A Device 190 


Volume 


a 


the devices are switched in the UCB address list. If necessary, any queued |/O requests for the volume on devices 


190 and 192 are exchanged so as to be on the correct queue. 


2. The DDR "PROCEED WITH SWAP" message is issued, and the operator exchanges the volumes on devices 190 and 192. 


Figure DDR-2. 


104 


Effects of DDR on system pointers 


The user-written routine must be named 
NSLREPOS and must be placed in SYS1.SVCLIB, 
for VS1, or SYS1.LPALIB for VS2. When DDR 
is ready to verify and reposition a tape 
without standard labels, it issues an XCTL 
macro instruction and passes control to 
NS LREPOS. 


Upon entry to NSLREPOS, register 0 con- 
tains the address of a two-word parameter 
list. The first word is the address of a 
48-byte field containing the label to be 
verified; the second word is the address of 
the UCB for the device. Register 2 con- 
tains the address of an XCTL list for 
NSLREPOS to use to return to DDR. Register 
5 contains the address of the SVRBs 
extended save area. 


When NSLREPOS completes its task, it 
should pass control (via the execute form 
of the XCTL macro instruction) to IGCOU08E 
with one of the following codes in register 
0: 
Code Explanation 
Volume verification is complete. A 
tapemark follows the label; there- 
fore the DDR tape reposition routine 
Should forward space to the tapemark 
and clear the block count it had 
accumulated before repositioning. 


4 More information is needed by 
NSLREPOS for volume verification. 
When the DDR tape reposition routine 
receives this code, it reads the 
first 48-bytes of the next record 
and returns to NSLREPOS. 


8 The wrong volume has been mounted. 
When the DDR tape reposition routine 


receives this code, it sends a mes-~ 
sage to the operator indicating the 
error and requesting that the 
correct volume be mounted. 


C Volume verification is complete. No 
tapemark follows the label so the 
DDR tape reposition routine should 
reposition the volume using the 
klock count it has accumulated. 


10 Volume verification is complete. 
The tapemark following the label has 
already been reached; the DDR tape 
reposition routine clears the block 
count it has accumulated and reposi- 
tions the volume. 


See the Tape Labels publication for 
additional details on writing the NSLREPOS 
program. 


RETRY PROCEDURE BY DDR AFTER SWAP 


For non-SY¥SRES devices, DDR sets up a 
request for the I/O operation that caused 
the swap to be initiated. Svc 15 is then 
issued for that request. If the I/O opera- 
tion fails again, the ERP is reentered. 
This entry is treated as a new error, and 
the ERP performs its normal functions. If 
the ERP determines that the error is per- 
Manent, DDR is requested again. 


For SYSRES devices, a permanent error 
was posted before DDR was initiated. The 
retry is a new attempt to perform the I/0 
Operation. If this retry fails, DDR does 
not try another recovery since the device 
is now judged not to be the cause of the 
failure. 
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DDR METHOD OF OPERATION DIAGRAMS 


These Method of Operation Diagrams show 
the functions of DDR and relate these func- 
tions to the exact modules and entry points 
in the code where they are performed. 


These particular diagrams are known as 
HIPO diagrams because they show Hierarchy 
as well as Input, Processing, and Output. 
The first diagram is a visual table of con- 
tents. The rest of the diagrams are 
arranged in a hierarchy according to the 
level of detail. 


Read the diagrams left to right, input- 
processing-output. The processing steps 
are numbered sequentially; these numbers 
also refer to the implementation notes at 
the bottom of most of the diagrams. The 
notes contain additional information about 
the processing steps. 


The arrows are used as follows: 


= 


Shows control flow to or from 
another program. 
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> 
ae 


(1111p 


425. 


Primary processing flow. Shows 
the path followed to accomplish 
the principal function of the 
body of code. 


Data transfer. Indicates that 
data is moved from one location 
to another. 


Control information transfer. 
Indicates the setting or changing 
of switches or pointers that will 
be used to determine the course 
of future processing. 


Pointer. Indicates that a field 
in one data area contains an 
address that points to another 
field or data area. 


Data reference. Indicates that 
the contents of a data area are 
tested or read in order to deter- 
Mine the course of subsequent 
processing. 
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DDR Section 2 


DDR SECTION 3: PROGRAM ORGANIZATION 


This section describes the DDR routines 
and the relationships klLetween them. 


Figure DDR-3 shows the relationship of 
the DDR routines to the DDR functions dis- 
cussed in DDR Section 2. Figures DDR-4 and 
DDR-5 show the flow of control between the 
various routines during the execution of 
DDR. Figure DDR-4 depicts DDR processing 
of system-initiated requests. Figure DDR-5 
depicts DDR processing of operator- 
initiated requests. 


LOCATING DDR 
For VS1 


The following DDR modules reside in the 
nucleus: IORMSCOM, IGFDDRSR, IGFDDRMF, 
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IGFVDDR2, and IGFVDDR3. These modules are 
permanently resident and are loaded during 
initial program load. The rest of the DDR 
rodules are loaded into the SVC transient 
area as needed. IGCOOO8E - IGCO808E, which 
make up SVC 85, reside in SYS1.SVCLIB. 
IGEO660A and IGC2503D also reside in 
SYS1.SVCLIB. 


Note: 1IGC2503D resides in SYS1.SVCLIB as 
part of SVC 34; its module name is 
IGC2503D. 





For VS2 


All DDR modules are permanently resident 
in the link pack area (SYS1.LPALIB), except 
those located in the nucleus - IORMSCOM, 
IGFDDRMV, IGFVDDR2, and IGFVDDR3. 







System-Initiated DDR 
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* Also executes swap for tape devices if Repouificnine’ Tacs 
request is operator-initiated. IGCO408E 
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DDR MODULE DESCRIPTIONS 


The following module descriptions summarize the functions of each CDR module. Addi- 
tional information about DDR modules can be found in the method of operation diagrams 
and in the prologues for each module. Prologues can be found on the microfiche. 


Note: Routines marked with * and listed under “Entered From" are routines that may 
enter via one of the DDR message routines. For example, one of the routines that 
enters IGCOOO8E is IGCO0O108E. Referring to routines that IGC0108E exits to, note that 
it passes control to IGCOOO8E via IGCO508E or IGCO808E. 


[(----- - - —— -- -- ---- - + -- 2 - = + + 5 ee ++ 
| IGCOOO8E - DDR Router 

F Ee re ee fe A Ie OO OO ee A a SR ea ee Ne PON re eee See Ear SE Ne ON 
{| Controls the execution of DDR: 

| 

| © Ensures that Device Allocation does not operate concurrently with DDR. 

| 

| e Routes control to the proper DDR routine to process the swap request. 

| © Terminates DDR execution. 

| 

}-------------7------------------- {-------------------------------—--------------------- 
| Entry Point | Entered From | Exits To 

}------------- $----------- fn rrr ner nner eer nae 
| IGCOOO8E | IGFDDRMF/MV { IGFDDRMF/MV (via SVC 3) when DDR is terminated. 

| | (via SVC 85) | 

| | IGCO108E* | IGCO208E if DDR request is system-initiated. 

| | IGCO 208E* | 

| | IGCO308E* | IGCO108E if DDR request is for direct access 

| | IGCO4O8E* | storage or unit-record devices and is operator- 

| | IGCO508E | initiated. 

| | IGCO608E | 

{ | IGCO808E | IGCO4O8E if DDR request is for tape devices and is 

| | |} operator-initiated. 

| | | 

| | | IGCO808E if the OPERATOR SWAP CANCELLED BY SYSTEM 

| | | message is to be issued. 

beh ete aS 2S Se Se es ee ng a ae Se ee eet 
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ee cs es ee es ee es ek 


J 


FSS ee ee ee ee ee en ee ane ee ee 1 
! IGCO108E - Operator-Initiated DASD DDR | 
fe 
| Executes operator-initiated DDR requests for direct access storage and unit-record | 
| devices: | 
| | 
| © Processes reply to SWAP message. | 
| | 
| © Gains control of devices. | 
| | 
| ©¢ Swaps UCB information. | 
| | 
| © Invokes routine to issue PROCEED WITH SWAP message. | 
| | 
BEES ara a aia ca aa a a ace { 
| Entry Point | Entered From | Exits To | 
}------------- }------------------- +-----------------------------—---------------------- { 
| IGCO108E | IGCOOO8E | IGFDDRMF/MV (via SVC 3) if the Swap is for SYSRES. | 
| | IGCO508E | | 
| | IGCO708E | IGCOOO8E (via IGCO508E or IGCO808E) to terminate | 
| | | DDR execution. | 
| | | 
| | | IGCO508E to issue messages. | 
| | | | 
| | | IGCO7VO8E if 3330s are being swapped. | 
i | | | 
| | {| IGCO808E to issue messages. | 
Gt A ee 5 page ee GaP ene ey se pce See eC ee Ne ee rates eae eel cee ee J 
aa a a a at ne a ee need a Cr ee ee age es 1 
{ IGCO208E - System-Initiated DDR I | 
| --------------------------------------------------------------------------------------- { 
| — | 
| © Determines TO device for a system-initiated request. | 
| | 
~------------;------------------- yo-t-------------------------------------------------- { 
| Entry Point | Entered From | Exits To | 
}------------- $------------------- }~-----------~------------------- ~--------- ---------- -{ 
{| IGCO208E | IGCOOO08E | IGCOOO8E (via SVC 7) if no RQES are on the DDR | 
| | IGCO308E* | wait queue. | 
| | IGCO508E | | 
| | | IGCOOO8E (via IGCO808E) if the operator requests | 
| | {| that DDR be terminated. | 
| | | | 
| | | IGCO308E if processing for the current request is | 
| | | to continue. | 
| | | | 
| | | IGCO508E to issue messages. | 
| | | 
| I | IGCO808E if DDR is to be terminated. | 
bose fea a ee a ee US a a as eS i J 
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e Swaps UCB information. 


-— Oe ee 


SEI tas Aa par Fak got eee a Ses 
| Entry Point | Entered From 

ome ay ee ee | ai aa a a eal me 
{| IGCO308E | IGCO208E 

| | IGCO508E 

| | IGCO708E 

| | 

| | 

| | 

| | 

| | 

| | 

| | 

| | 

| | 

| [ 

| | 

| | 

| | 

cae ea a fee an ee ry aT ee ae SPR eee ee re 


-———— — — — — —— —— _ — _— + _ 4 


— ae oe we oe eo oe ee © © © © oe ee se © © oe © 9 © 2 © 9 9 es 2 es 


Completes execution of system-initiated swaps: 


e Gains control of devices for a system-initiated swap. 


e Invokes routine to issue PROCEED WITH SWAP message. 


IGCOOO8E (via SVC 7) if no RQES are on the DDR 
wait queue. 


IGCOOO8E (via IGCO808E) if DDR is to be terminated. 


IGCO208E (via IGCO508E) if a new TO device must be 
specified by the operator. 


IGCO4O8E (via IGCO508E) if operator is to exchange 
volumes. 


IGCO508E to issue messages. 
IGCO708E if 3330s are Lkeing swapped. 


IGCO808E if DDR is to Le terminated. 


Repositions tapes after swap and: 


devices, Swaps UCB information, and invokes routine to issue PROCEED WITH SWAP 


message. 


e For system-initiated DDR requests involving tape devices, initializes system con- 


troi blocks. 


IGC0408E 


| 

+ 

| IGCO008E 
l IGC0308E* 
| IGCO508E 
| IGC0608E# 
| NS LREPOS 
| 

| 

| 

i. 
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c 
| 
t 
| 
| « For operator-initiated DDR requests involving tape devices, gains control of 
| 
| 
| 
| 
| 
f 


IGCOOO8E (via IGCO808E) if DDR is to be 
terminated. 


IGCO508E to issue messages. 
IGCO0608E to reposition the tape. 


IGCO808E if DDR is to be terminated. 


PT 
{ « Issues messages and exits to routine specified in DDRWORK + 12 (in IORMSCOM). | 
| | 
RECEP CEE Sa aa aa aa Eerste eee en ree ae ey pe oT { 
| Entry Point | Entered From | Exits To | 
~------------ }-------------------4-----------------------------------------------------4 
{| IGCO508E | IGC0108E | IGCOOO08E after issuing PROCEED WITH SWAP message [ 
| | | for other than 3330s. | 
| | | 
| | | IGC0O108E after issuing PROCEED WITH SWAP message | 
| | | for 3330s or after issuing SWAP message. | 
| }------------------- }----------------------------------------------------- { 
| | IGCO208E | IGCO208E always. | 
| }------------------- }----------------------------------------------------- : 
| | IGCO308E | IGCO208E after issuing INVALID FOR SWAP message. | 
| | | | 
| | | IGCO308E after issuing PROCEED WITH SWAP message | 
| | | for direct access storage or unit-record devices. | 
| | | | 
| | | IGCO408E after issuing PROCEED WITH SWAP for tape | 
| { | devices. | 
| }------------------- }----------------------------------------------------- { 
| | IGCOUO8E | IGCO408E after issuing SWAP or ERROR messages. | 
| | | | 
| | | IGCO608E after issuing PROCEED WITH SWAP message. | 
| }------------------- }----------------~------------------------------=----- { 
| | IGC0608E | IGCO408E after issuing ERROR message. | 
| |------------------- }----------------------------------------------------- { 
| | IGCO908E | IGCO908E if a new TO device is specified by the | 
| | | operator. l 
SSS tse e ose boo See e Saas Se ee ee ee ee a oe eee Se Sat 

| Note: See DDR Section 6 for a list of messages. | 
Ui ee a a ie 8 Se eS J 
Ce ye ee Oe ee ee ety er ee eg a, ey 7 
| IGCO608E - Tape Label Verifier | 
De ee eer 
| « Verifies tape labels after a swap has been completed. | 
| | 
ps eer erro i ee ee Me re iat eae ee a ee et, eT Oey et | 
| Entry Point | Entered From | Exits To | 
}------------- ¢------------------- ----------------------------------------------------- { 
{| IGC0O608E | IGCO4O8E* | IGCOOO8E if swap is for DDR dump tape. | 
l | IGC0508E | | 
| | IGCO808E | IGCO4O8E (via SVC 7) if reposition is successful. | 
| | | | 
| | | IGCO4O8E (via IGCO508E) if an I/O error is | 
| | | encountered. | 
| | | | 
| | | IGCO508E to issue ERROR message. | 
| | | | 
| | | IGCO808E if the wrong volume is mounted. | 
| | | | 
| | {| NSLREPOS if the tape does not have standard labels. | 
be ee ep a ee ee am ea pe pe ge pe eee fe eR peg Eee Are ee Era J 
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Fe a a ee ee eg re ee ee ee ee ee tae 
| IGCO708E - Recording | 
en 
| * Records 3330 buffer sense information on SYS1.LOGREC. (Records are handled via SVC | 
| 76.) | 
| | 
| ama cle nm| ep ee ee Ba a aaa a ae aaa aE | 
| Entry Point | Entered From | Exits To | 

~----------- f-------------------}----------- +--+ == ------ === $= -- === === === == =f 
| IGCO708E | IGCO108E {| Caller always. | 
| | IGCO308E | | 
beech os ees as ate ee I a Se ee en J 
a ge ere ae ee Fe he ee ee eg Fe nee 1 
| IGCO808E - Message Writer II | 
Pe ee, ee te 
| « Issues messages and exits to routine specified in DDRWORK + 12 (in IORMSCOM). | 
| 
}-------------7---------=-----——-- Pn enn nn an rn nn en nnn nnn { 
| Entry Point | Entered From | Exits To | 
|------------- }------------------- }~---------------------------------------------------- { 
{| IGCO808E | IGCOOOS8E | IGCOOO8E if entered by other than IGCO608E (to | 
| | IGC0108E | terminate execution). | 
| | IGCO208E | | 
| | IGC0308E | IGCO608E if entered by IGCO608E (to continue | 
| | IGCO4O8E | execution.) | 
| | IGC0608E | | 
bs 2 oe ee Pen escecosseta aoe 2s ee a a J 
aa aa a a a Ra RT a eR a aaa 1 
| IGCO908E - Tape Validation | 
ee 
| « Validates operator's reply to a tape swap. | 
{ | 
(ha a a ERIS 1 ear ala a i ole oa tg a ee ag pe Se a at rg weg ee pee, { 
{| Entry Point | Entered From | Exits To | 
|------------- $-—----------------- $--22-----------—2------- -----------2 === { 
| IGC0O908E | IGCO508E | IGCO4O08E to continue tape processing. | 
| | | | 
| | | IGCO508E to issue the swap or invalid message. | 
| | | | 
| | | IGCO808E to issue terminate message. | 
Go SS pee ee ee eee mene ao rk I ee er ee J 
Ce a a ee 1 
| IGEOQ660A - DDR Central | 
}--------------------------------------------------------------------------------------- { 
! 
| Sets up DDR for processing of system-initiated requests: { 
! | 
{| e Verities system-initiated requests for DDR. { 
l | 
| @« Places failing RQE on DDR wait queue. | 
| | 
| @¢ Posts DDRECB. { 
| 
|------------- y------------------- qn no 2-2-2 === === === = === === - ! 
| Entry Point | Entered From | Exits To 
-----=------- $------- += -- == === =f == $= $= = $n enn nnn nnn nnn nnn nnn nn nf 
'  IGEO660A | IGEOQ125F (OBR { Cailer always. i 
eee toe deo pee ee Sl fee epee re Re ek re Pee eae eee J 
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IGFDDRMF - DDR Resident (VS1) | 
IGFDDRMV - DDR Resident (VS2) 


Initiates execution of DDR: 
e Waits for DDR to be activated; that is, waits for CDRECB to be posted. 
e Initiates the processing of a DDR request. 
Note: If a program check occurs ina DDR routine, the DDR STAE routine is entered at 


IGFVSTAE from the system STAE. The DDR STAE routine is an integral part Of IGFDDRMV; 
it is only present for VS2. 





cet el ee ee Se ee ee ees ee eee oem 


f--— ow ee Eb UD ee ee ee ee ee ee > ee ee cee = ee ee es es ee we a oe On 8 ee oe on ee en en a ee en en oe ee ee we ee ee ee ee ee 
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IGFDDRSR - DDR SYSRES (VS1 only) 


Handles all DDR functions for SYSRES: 


Determines if DDR should be invoked for an error involving SYSRES. 


e Determines the TO device if the swap is system-initiated. 
e Gains control of the devices. 

e Swaps UCB information. 

e Issues message requesting operator to exchange devices. 


1 
| 
4 
| 
| 
| 
| 
{ 
e Prohibits Device Allocation from operating while DDR is being executed. | 
| 
| 
| 
| 
| 
| 
| 
| 
e Verifies that correct volume was mounted on the TO device. | 

| 


FINCH { Caller always. [ 
IGFDDRMF | | 


+ 
IGF400 Ios { IOS (via IOS-DDR vector table) always. | 


en eR et rn nn tt et rs re rr er rr nee -| 
IGFDDRO5 i Disk ERP { Caller always. | 
oe we a a a rr ee SSS re ee ee a 


Note: IGFDDRO5 is entered whenever a permanent error is encountered in an I/O opera- 
tion involving SYS1.SVCLIB on SYSRES. IGCDDRO5 determines whether DDR SYSRES may be 
invoked. 





IGF400 is the channel end appendage for SVC 15s that are issued by DDR SYSRES. 


IGFDDRSR performs all other DDR functions related to a SYSRES swap. 


En ee eS 
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Sr a ne en ee a er a ea ea 1 
| IGFVDDR2 - Channel End Appendage | 
Ne a ae nhc et te eh bees es 
| | 
| Controls DDR I/O operations (SVC 15): | 
l | 
| e Determines what I/O operation is requested when a DDR routine issues SVC 15. | 
| | 
| « Takes the appropriate branch into IOS using the IOS-DDR vector table. l 
| | 
}}------------4------------------- Ton nnn nnn nnn -4 
| Entry Point | Entered by | Exits To | 
_----~---—-- fo------- == === === =f === - =~ == -- ~~ + ----- ~~~ 
| IGFDDRO2 | Ios | IOS (via the vector table) always. | 
Saale ee y een eeen eye eam ae ne faye keeps A pm ne OO a EINE IR Ec OE NEE vpn ere eo eR aI 


| Note: The following DDR routines use this routine via SVC 15. IGCOOO8E, IGCO1OSE, 
| IGCO208E, IGCO308E, IGCO4O08E, IGCO608E, and IGCO708E. 


bossa S Se a ee ee ee a a ee J 
ig a Sc Raa No ca a la a a ae a 1 
| IGFVDDR3 - Abnormal End Appendage | 
ee a ee 
| « Processes error conditions encountered in I/O operations initiated by DDR. | 
| | 
|-------------y------------------- [~~~ ~~~ ---- $+ == - === === === == === : 
| Entry Point | Entered From | Exits To | 
~------------ }-------------------}-----------------------------------------------------4 
| IGFDDRO3 | Ios {| IOS via IOS-DDR vector takle if permanent error is | 
| | | detected, otherwise via return to caller. | 
ste Sete 6 ee ee een nee ae Whe te dh ee ae a es ee ee ee J 
aa a aa a a a Raa 1 
| IGC2503D - SWAP Command Processor | 
| -------------------------------------------------------------------------------------- { 
| | 
| Sets up DDR for operator-requested swaps: | 
| 
| © Verifies the SWAP command and determines whether DDR can be invoked for an | 
| operator-initiated request. | 
| | 
| © Determines whether operator-specified tape devices are eligible for swapping. | 
| | 
| © Posts DDRECB. | 
| | 
aa ae Sere ee fe ee Me peg eg ee SS Ort ee os ee pi ee { 
{| Entry Point | Entered From | Exits To | 
[------------- 4------------------- }-------------~-------~------------------------------ { 
{| 1GC2503D | IGcO403D (SVC 34 | Caller if DDR is to process the request. | 
| | command moduie) | IGG2103D (IOS message module) if DDR is not to pro- | 
| | | cess the request. | 
be See gee ie a ee Mh oa ee ee ee ee Se ee ee J 
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DDR SECTION 4: DIRECTORY 


c 


The directory provides a quick reference Library: The place where the module 
from this publication to the pertinent cod- resides. (For VS2, all DDR modules reside 


ing, or from the coding back into the pub- in the link pack area, except those located 
lication. The directory contains the fol- in the nucleus - IORMSCOM, IGFDDRMV, 
lowing information: IGFVDDR2, and IGFVDDR3.) 
Module and CSECT Name: The name of the 
object module and the CSECT containing the Name: The descriptive name used to refer 
coding indicated by the label. to the module. 
o ‘ : 
Label: Names taken from the listing for 
entry points, significant sections of cod- Diagram: The method of operation diagram 
ing, and data areas. containing information about the coding 
identified by the label. 
Description: A synopsis of the function of 
the coding indicated by the lakel. 
FSS ye To ee ee ee ee eee ae ee fo a ee ee eee Baoan | 
|Module and| | | | |Dia- | 
|CSECT Name| Label | Description | Library | Name [gram | 
}---------- }---------- }------------------------------ +------------------ }------------------------ +----- 
| IEANUCO1 | IGF201 | Contains addresses and | Nucleus | DDR Communications | | 
| IGF201 | | status indicators | | Area | | 
}---------- +---------- ------------------------------ 4------------------ $------------------------ }----- { 
| IGCOOO08E | IGCOOO8E | Controls DDR execution | SYS1.SVCLIB (VS1)| DDR Router | 4 | 
| | | | SYS1.LPALIB (VS2)| | | 
~-------- }----------}------------------------------}-+-----------------}------------------------+-----4 
| IGCO108E | IGC0108E | Processes operator-initiated | SYS1.SVCLIB (VS1)| Operator-Initiated | 4 | 
| | | requests for direct access | S¥S1.LPALIB (VS2)| DASD DDR | | 
| | | and unit-record devices | | | | 
}---------- +---------- }------------------------------ +------------------ $-------------—---------- t-=---4 
| IGCO208E | IGCO208E | Determines TO device for | SYS1.SVCLIB (VS1)| System-Initated DDR I | 5 | 
| | | system-initated request | SYS1.LPALIB (VS2) | | | 
}---------- +---------- }------------------------------ }------------------ }------------------------ $-----4 
| IGCO308E | IGCO308E | Executes swap for system- | SYS1.SVCLIB (VS1)| System-Initiated | 5 | 
| | | initiated request | SYS1.LPALIB (VS2)| DDR II | | 
}---------- }---------- }------------------------------ +------------------ $------------------------ -----4 
| IGCO4O8E | IGCO4O8E | Processes operator-initiated | SYS1.SVCLIB (VS1)| Operator-Initiated | 5,6 | 
| | | requests for tape devices; | SYS1.LPALIB (VS2)| Tape DDR | | 
| | | repositions tapes | | | | 
}---------- }---------- }------------------------------ +------------------ }------------------------ +----- 
| IGCO508E | IGCO508E | Issues DDR messages | SYS1.SVCLIB (VS1)| Message Writer I | 5,6 | 
| | | | SYS1.LPALIB (VS2) | | | 
}---------- ---------- }------------------------------ ------------------ }------------------------ t-----4 
| IGCO608E | IGCO608E | Verifies that correct tapes | SY¥YS1.SVCLIB (VS1)| Tape Label Verifier | 5,6 | 
| l | are mounted | SYS1.LPALIB (vS2) | | | 
}---------- t---------- }------------------------------ }------------------ +------------------------ +-----4 
| IGCO708E | IGCO708E | Records error statistics for | SYS1.SVCLIB (VS1)| Recording | 5,6 | 
| | | 3330s | SYS1.LPALIB (VS2)| | | 
--------- }----------}------------------------------}------------------}------------------------4-----4 
| IGCO808E | IGCO808E | Issues DDR messages | SYS1.SVCLIB (VS1)| Message Writer II | 5,6 | 
| | | | SYS1.LPALIB (VS2)| | | 
|-~~---—-- {---------- }------------------------------ }~----------------- }------------------------ $-----4 
& | IGCO908E | IGCO908E | Validate operator's reply to | SYS1.SVCLIB (VS1)| Tape Validation | | 
| | | a tape swap | S¥YS1.LPALIB (VS2)| Routine | | 
---------- }----------}------------------------------ +--+ ----- = ------- 4 --=-------------------- f-----4 
| IGEO660A | IGEO660A | Verifies system-initiated | SYS1.SVCLIB (VS1)| DDR Central | 2 | 
| | | requests | SYS1.LPALIB (VS2)| | | 
a t SS eee eae + pe ee + pi a ASL GaGa ae an a Ges a + Paget cco idgtiat ay wal a a se ae + eet at Ge ey I Big fa + Srecaed 4 
| IGFDDRMF | DDRRB | RB for DDR | Nucleus } DDR Resident | 4 | 
| | | | | | | 
| | IGFDDRFC | Marks end of DDR save area | | | 4 | 
| | | | | | | 
| | IGFDDRMF | Initiates execution of DDR | | | 4 | 
| | | request (VS1) | | | | 
| | IGFDDRND | Marks end of DDR save area | | | 4 | 
| | | | | | | 
| | IGFDDRO1 | Alternate entry point name | | | | 
| | | | | | | 
| | IGFDDR11 | Alternate entry point name | | | | 
| | | | | | | 
| | IORMSSVC | Issues SVC 85 (VS1) | | | 4 | 
| | | | | | | 
Cc | | IORMSWT | Issues WAIT for DDRECB (VS1) | \ | 4 | 
Posse Ssoee Cee ea ee A eee et ee Be Daas Se dessa a Se Ree ee sae J 
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r T foe So Se a SH SS sos SoS S-S4= 7S Se SH See > ss= 1 
|Module and| | | | |Dia- | 
|CSECT Name| Label | Description | Library | Name |gram | 
}---------- +---------- }------------------------------ }------------------ }------------------------ t-----4 
| IGFDDRMV | IGFDDRMV | Initiates processing of DDR | Nucleus | DDR Resident | 4 | 
| | | request (VS2) | | | | 
l | | | | | | 
| | IGFVSTAE | Terminates DDR when a | | | | 
| | | program check occurs | | | | 
| | | | | | | 
| | IORMSSVC | Issues SVC 85 (VS2) | | | 4 | 
t | | | | | | 
| | IORMSWT | Issues WAIT for DDRECB (VS2) | | | 4 | 
}---------- +---------- }------------------------------ }------------------ }------------------------ t-----4 
| IGFDDRSR | IGFDDRSR | Handles DDR requests | Nucleus | DDR SYSRES | 7 | 
| | | involving SYSRES | | | | 
| | | | | | | 
| | IGFDDRO5 | Determines if the system | | | | 
| | | should invoke DDR for an | | | | 
| | | error on SYSRES | | | | 
| | | | | | | 
| | IGFODEB | DEB for DDR SYSRES | | | | 
| | | | | | | 
| | IGFOIOB | IOB for DDR SYSRES | | | | 
| | | | | | | 
| | IGF400 | Determines proper interface | | | | 
[ | | between DDR SYSRES and IOS | | | | 
| | | when an SVC 15 is issued by | | | | 
| | | IGFDDRSR | | | | 
(aaa eae ee foSsssSo=—— a aac re a ea ace ari 1 es aig ame tesa | ha nen ec f==S= { 
| IGFVDDR2 | IGFVDDR2 | Determines proper interface | Nucleus | Channel End Appendage | | 
| | | between DDR and IOS when an | | | | 
| | | svc 15 is issued | | | | 
(==4S-4=--- : ae aa patie | SR ee ae ee ani cece Sanaa a : (eee RE Sa ae a 1 
| IGFVDDR3 | IGFVDDR3 | Processes error conditions | Nucleus | Abnormal End Appendage | | 
| | | during DDR I/O | | | | 
fesse SeSS : ee rER RRO fo See Se eae ee | Mua nan oa ECS sas HC AE Ges AIS a IRS a ah f-s=-= 1 
| IGF2503D | IGF2503D | Verifies operator-initiated | SY¥S1.SVCLIB (VS1)| SWAP Command | 3 | 
| | | requests | SYS1.LPALIB (VS2)| Processor | | 
Say almanacs : stat cai waatanas $s S aes ea Se Sess 1 tancgnies aici nine cermin cae yaar t--+-- { 
| IORMSCOM | DDRECB | ECB for DDR | Nucleus | DDR Communications | | 
| | | | | Area [ | 
Ce ofesee cs oe ae eee eae Bs Sie oe eee eee See Bee Ste ee et esos Se oe tees Deere J 
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DDR SECTION 5: DATA AREAS 


This section contains descriptions of the principal data areas used by 
DDR: 


® DDR communications area (IORMSCOM) 
e IOS-DDR vector table 


The symbqjic names shown in individual fields represent the displace- 
ment, in bytés, from the beginning of a specific data area to the field. 
Access is gained to a specific field by using an instruction in which the 
beginning address of the area (usually contained in a register) is the 
base address, and the symbolic field name represents the displacement. 
Use of the fields can be traced in the DDR listings by first locating the 
symbolic field names in the cross-reference table at the back of the 
listings and then noting where the names are used. 


The field headings and their meanings are: 
Displacement: The numeric address of the field relative to the beginning 
of the data area. The first number is in decimal; the second (in paren- 
theses) is the hexadecimal equivalent. 
Bytes and Bit Patterns: The size (number of bytes) of the field and the 
bit settings of flag fields; that is, the state of bits ina byte. When 
the column is used to show the state of bits, it is shown as follows: 
esee eee The eight bit positions (0-7) in a byte. For ease of scan- 
ning, the high-order (left-hand) four bits are separated 
from the low-order four Lkits. 
1... ..-- A reference to bit 0. 


eccee oe XX BitS 6 and 7 are reserved. 


Bit settings that are significant are shown and described. Bit settings 
that are not presently significant are described as reserved bits. 


Field Name: A name that identifies the field. 


Field Description: The use of the field. 
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IORMSCOM is the DDR communications area. 
face between the DDR routines, 


er parts of OS/VS. 


DDR COMMUNICATIONS AREA (IORMSCOM) 


It provides the major inter- 
as well as interfaces between DDR and oth- 


The base address of IORMSCOM is contained in the first word of the 


SYS1.LOGREC DCB. 


Notes: 


Check Handler). 
of this publication. 


In addition, the address can usually be found in one of 
the registers if DDR is being executed. 


For a description of this area, 


The first 20 bytes (0-19) of IORMSCOM are used by CCH (Channel- 


refer to CCH Section 5 


Figure DDR-6 is provided to assist in locating DDR fields in IORMSCOM. 
This figure contains an alphabetic list of the fields with their 
displacements. 


TT 
Displacement|| Field 


CS oP T 
| Field | 
LaTTOCECH ~t-- 3 
lattoctca | 24 
lartotgip | 28 
lautcuasR | 60 
| BLKCNT | 68 
| BRET | 260 
lenstip |! 52 
COREADDR | gg 
DDRBUFR | 280 
| pprRcount |! 92 
| ppRpEBEsd!:so212 
lpprecB |! 76 
| ppRFLGSA | 36 
Figure DDR-6. 


tt DRFLGSB 


DDRFLGSC 
DDRFLGSD 
DDRFLGSE 
DDRFLGSF 
DDRFMUCB 
DDRIOB 
DDRTOUCB 
DDRWORK 
FILECNT 
IOSECB 
IOSVT 


Locations of fields 


tS ee oe aes cel a aaa 
|Displacement|| Field 

t 40 (28) tt OSVTA 

| 44 (2C) | GURROE 

| 48 (30) I | PEPLYBUF 

| 74 (4A) ll eMSTCB 

| 75 (4B) I! RMSTCBA 

| 56 (38) ll cySRESAD 

| 152 (98) I! GSRDCB 

| 58 (3A) | GSRDEB 

| 104 (68) | OSRROE 

72 (48) I! osRTcs 

| 80 (50) | | USRTCBA 

; 44 (2c) | | XCTLLIST 
BRS Ee a a ae A 


in IORMSCOM 


-p——— — —— —— — —— — +—4 


Bytes and 


Displacement Bit Patterns Field Name Field Description 

20 (14) 4 ALLOCECB ECB for Device Allocation. 
Used to keep Device Allocation 
from being executed currently 
with DDR. 

24 (18) 4 ALLOCTCB If Device Allocation is 
active, this field contains 
the address of the TCB for the 
task for which Device Alloca- 
tion iS being executed. 

28 (1C) 2 ALLOTJ ID OS/VS2 ~ TJID of the task for 
which device allocation is 
being executed. 

30 (1E) 2 Reserved. 

32 (20) 4 USRDEB Address of the DEB for the 
data set being swapped. 

36 (24) 0 SYSRESAD (See displacement 37.) 

36 (24) 1 DDRFLGSA DDR flags. 

Wai eS SYSRESOP This version of DDR can pro- 
cess swap requests for SYSRES 
(VS1 only). 

ee Wie “Sotanw DDRBUSY DDR request being processed. 

panels leoatiee DDRON System-initiated requests 
permitted. 

grantee. costed VALIDATE Verify the TO device. 

Srareie <e Los NSLUSER The volume being processed 
does not have standard labels. 

aera! cares NSLAVAIL An NSLREPOS routine has been 
provided. 

etwrane “Seek OPINIT The request being processed is 
Ooperator-~initiated. 

i ae ee ee Reserved. 

37 (25) 3 Address of IGFDDRSR (VS1 
only). 

4O (28) 0 RMSTCB (See RMSTCBA, displacement 
41). 

4O (28) 1 DDRFLGSB DDR flags. 

oe ee SWAPMSG Issue SWAP message. 

eiktem,  aaieee INVALID Issue INVALID FOR SWAP 
message. 

eee. car as SYSRES Issue SYSRES RESIDENT ON warn- 
ing message (VS1 only). 

eee Geen DDREND Issue TAPE DDR TERMINATED 
message. 

ere ae eee PROCEED Issue PROCEED WITH SWAP 
message. 

esatietien Sik a SHRDASD The device involved in the 
Swap is a Shared direct access 
device. 

euee: suede NOTOUCB A TC device was not found for 
a syStem-initiated swap request. 

areueaiey’ « iahtates ds FIRSTIO Svc 15 has been issued to gain 
control of a device. 

41 (29) 3 RMSTCBA Address of TCB for DDR. 

Wu (2C) 0 IOSVT (See IOSVTA, displacement 45.) 
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Bytes and 


Displacement Bit Patterns Field Name Field Description 
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44 (2C) 1 DDRFLGSC DDR flags. 

Visdem, scores TERMINATE Terminate DDR. 

oy ner eee STAE The DDR STAE routine has 
intercepted a program check 
(VS2 only). 

eels eee CANCEL Issue OPERATOR SWAP CANCELLED 
BY SYSTEM message. 

Scene Lk “wb as ERROR Issue ERROR message. 

Sowa lees SWAPUCB Svc 15 has been issued to swap 
UCB information. 

eae Sew REPOSITN A tape that has been swapped 
must be repositioned. 

oie. doce es ILONOCTRL Svc 15 has been issued to re- 
EXCP without control. 

oere. eee ERPINPRO Issue AN ERP IS IN PROCESS 
message. 

45 (2D) 3 IOSVTA Address of IOS-DDR vector 
takle. 

48 (30) 0 USRTCB (See USRTCBA, displacement 
49.) 

48 (30) 1 DDRFLGSD DDR flags. 

aaa. eveiese SYSRES BR Branch to IGFDDRSR. An 
operator-initiated swap speci- 
fied SYSRES as the FROM device 
(VS1 only). 

elec coac DDRMSG Issue WRONG VOLUME MOUNTED 
message if this bit is off, 
and bit 0 of DDRFLGSD is on. 

Smies waco DUMPTAPE The tape device involved in 
the current DDR operation has 
a dump tape mounted. 

eel ecm eee READ Read a record. 

Oe eee ae rare STADLABEL The tape volume being pro- 
cessed has standard labels. 

came cekes UNLABELD The tape volume being pro- 
cessed is unlabeled. 

waaces Meike FORSPACE Forward space file. 

ee ae ee IOCONTRL Svc 15 has been issued to re- 
EXCP with control. 

49 (31) 3 USRTCBA Address of the TCB for the 
task for which DDR is being 
executed. 

52 (34) 1 CNSLID Save area for Console Identi- 
fication; used if operating 
under MCS. 

53 (35) 3 USRDCB Address of the DCB for the 
data set involved ina Swap. 

56 (38) 2 DDRFMUCB Address of the UCB for the 
FROM device. 

58 (3A) 2 DDRTOUCB Address of the UCB for the TO 
device. 

60 (3C) 4 ALTCUASR Address of alternate SYSRES 
device (VS1 only). 

64 (40) 2 USRRQE Pointer to RQE for I/O opera- 
tion for which DDR is being 
executed. The DDR request was 
initiated by the system. 

66 (42) 2 OU RRQE Pointer to ROE for DDR. 

68 (44) 4 BLKCNT Block count for magnetic tare. 

72 (48) 2 FILECNT File count for magnetic tape. 


Displacement 


74 


75 


76 


80 


84 
88 
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152 
212 
260 
264 
272 


280 


(4A) 


(4B) 


(4C) 


(50) 


(54) 
(58) 


(5C) 
(60) 
(62) 
(64) 
(68) 


(88) 


(98) 
(D4) 
(104) 
(108) 
(110) 


(118) 


Bytes and 
Bit Pattern 


eee 


Pie eae 


Paes ee 


eae kt 


a eee 


ae ee 


eo lee 
ee eck: 


1 


ara 


el. 


rere ke 


‘wave 
i esd 


a Le 
eceol 


Fre 


COLNN 


Field Name 


DDRFLGSE 


RETRY 


WRONGVOL 


LABLPROC 


READFROM 


FMERROR 


TOERROR 


RECRDING 
READTO 
DDRFLGSF 


COMPLETE 
REENTRY 


REINIT 
LABELERR 


DDRINIT 
OPCANCEL 
NEGCOUNT 
DDRFIX 
DDRECB 
IOS ECB 


REPLYBUF 
COREADDR 


DDRCOUNT 


DDRWORK 


XCTLLIST 


DDRIOB 
DDRDEB 
BRET 
FIXECB 
FIXLIST 


DDRBUFR 


Field Description 
DDR flags. 


Retry the I/O operation that 
caused the system to invoke 
DDR. 

Issue WRONG VOLUME MOUNTED 
message. 

Verify that the correct volume 
(tape) has been mounted. 

Read 3330, 3330-1, or 3340 
buffer. 

Error was encountered reading 
FROM 3330, 3330-1, or 3340 
buffer. 

Error was encountered reading 
TO 3330, 3330-1, or 3340 
buffer. 

Record 3330, 3330-1, or 3340 
buffer. 

Svc 15 was issued to record a 
3330, 3330-1, or 3340 buffer. 
DDR flags. 

Issue SWAP COMPLETE message. 
The DDR abnormal end appendage 
was entered. Used by 
IGCO508E, when calling 
IGCO908E, to validate a 
device. 

Reinitialize DDR block count. 
An error was encountered while 
attempting to verify and repo- 
Sition a tape after a swap. 
Initialize DDR. 

Cancel operator-initiated 
Swap. 

Initialize block count to -1. 
User LCB page has been fixed. 
ECB for DDR Resident routine 
(IGFDDRMV). 

ECB for return from I0S. Used 
to determine when an SVC 15 
has been completed. 

Reply buffer for DDR messages. 
Pointer to main storage 
obtained for recording 3330, 
3330-1, or 3340 sense buffer 
information. 

Reserved. 

Contains CNOP 4,8 instruction. 
Reserved. 

Block count. 

Work area. DDRWORK + 12 is 
used by the DDR load modules 
of SVC 85 to indicate succes- 
sor routines. 

XCTL list for NSLREPOS 
routine. 

IOB used by DDR. 

DEB used by DDR. 

BR 14 instruction. 

ECB for user's fixed page DCB. 
Parameter list for page 
fixed/freed. 

Buffer for DDR I/O. 
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IOS-DDR VECTOR TABLE 


is in I0OS. 


DDR uses the IOS-DDR vector table to perform I/O operations. The vector table 


See "I/O Handling -- IOS-DDR Interface" in DDR Section 2 for details 


on how the table is used. The following is a description of the vector table: 


Displacement 


136 


0 


4 


12 


16 


20 


24 


28 


32* 


3 6* 


Meaning 
Address of DDR wait queue. 


Branch to re-EXCP with control of device. Turns on the UCB 
error flag (UCBERR in UCBFL1), and stores a pointer to DDR‘s RQE 
in UCBLTS. The RQE is then queued on the logical channel queue, 
and Channel Restart is entered. 


Branch to re-EXCP without control of the device. Resets the UCB 
not-ready flag (UCBNRY in UCBFL1), queues the RQE on the logical 
channel queue, and enters Channel Restart. 


Branch to POST without control of device. Resets the UCB error 
flag, enters IOS-POST interface to post the user's request, and 
then enters Channel Restart. 


Branch to POST with control of device. Turns on the UCB error 
flag. The IOS-POST interface is entered to post the user's re- 
quest, then Channel Restart is entered. 


Branch to retry user‘s request. Dequeues the user‘s ROE from 
the DDR wait queue and queues it on the appropriate logical 
channel queue. The UCB error flag is then turned on, anda 
pointer to the user's RQE is stored in UCBLTS. Pointers to the 
IOB, DEB, and DCB are set up. The DCB error flags are reset, 
and control is routed to re-EXCP the user's I/O request. 


Branch to swap UCB information. Exchanges device information 
between the TO and the FROM devices, but leaves volume informa- 
tion alone. Channel Restart is then entered. 


Branch to cancel DDR. Dequeues the user's RQE from the DDR wait 
queue, sets the UCB error flag, and posts the user with a per- 
manent I/O error. (If the RQE is not on the wait queue upon 
entry, I0S exits to Channel Restart.) 


Branch to cancel DDR SYSRES. (This branch is taken only when an 
Operator-initiated swap for SYSRES is interrupted by a systen- 
initiated swap request for SYSRES.) Dequeues the DDR SYSRES RQE 
from the logical channel queue and enters Channel Restart. 


Branch to re-EXCP for SYSRES DDR on condition code 3. (This 
branch is taken only when DDR is being executed for SYSRES.) 
Prevents a reseek on the I/O operation Ly setting the UCBASK bit 
in UCBFL1 of the UCB (except for devices with rotational posi- 
tion sensing). Then uses re-EXCP to perform the I/O request. 


*These entries exist only for VS1. 


This section contains information to aid 
in locating errors in DDR. Discussions on 
register usage, messages, and SYSRES pro- 
cessing are included. 


REGISTER USAGE 


Figure DDR-7 indicates the significant 
contents of general purpose registers upon 
entry to the specified DDR modules. 


MESSAGES 


DDR messages can be issued by three dif- 
ferent modules: 


e IGFDDRSR if a swap for SYSRES is being 
executed (VS1 only). 


e IGCO508E or IGCO808E if a swap is not 
for SYSRES. 


Figure DDR-8 shows the messages, the 
modules that issue them, and the modules 
that request each message to be issued. 


IGFDDRSR_ PROCESSING (VS1 ONLY) 


The DDR SYSRES routine (IGFDDRSR) is 
Segmented into a number of subroutines. 
Entry to these subroutines is usually via a 
BAL instruction, while exit from them is 
usually via a branch to the address speci- 


DDR SECTION 6: DIAGNOSTIC AIDS 


fied by the BAL instruction. (The exit 
address specified by the BAL instruction is 
usually contained in LINKRG, register 8.) 


Figures DDR-9 and DDR-10 are provided as 
an aid to understanding the relaticnship 
ketween the subroutines and the rest of the 
module. These figures indicate the events 
that occur in IGFDDRSR during swapping of 
SYSRES. 


The figures are alike. The action 
column iS a summary of the operations per- 
formed in IGFDDRSR. The sequence number 
column indicates the sequence in which 
these operations are performed. The label 
column specifies where in IGFDDRSR these 
operations are performed. 


First, select the appropriate figure; 
Figure DDR-9 pertains to system-initiated 
swaps for SYSRES; Figure DDR-10 pertains to 
operator-initiated swaps for SYSRES. Next 
find number 1 in the sequence column of the 
selected figure. Then use the sequence 
numbers, Starting with 1, to trace the 
sequence of events. (Figures DDR-9 and 
CDR-10 show the sequence of events for a 
successful SYSRES swap only; error paths 
are not shown.) 


Note: SYSFLG1 is used by IGFDDRSR to ind- 
icate what processing is to be done. SYS- 
FLG1 is in IGFDDRSR, and it is set and 
reset Ly that routine throughout DDR SYSRES 
processing. 
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pear ees a eg ee tm ee rg en eg ee eae re ee eg ey. Stoo ee Mos ee ee ee 
| Message Number | Issued By | Requested By | 
}--------------------------------+--------------------------- +----------- {-----------—-- { 
| IGF500I SWAP xxx TO yyy | IGCO508E | IGC0108E | 
| IGF500D REPLY ‘YES', DEVC, OR ‘NO' | | IGCO208E | 
| REPLY 'YES', OR ‘NO! | | IGC0308E* | 
| | {| IGCO4O8E | 
|-------------------------------~---------------------------- +----------- +-------------- { 
| IGF501D SWAP SYSRES FROM xxx TO yyy | IGFDDRSR | IGFDDRSR | 
}------------------------------------------------------------ +----------- ¢-------------- { 
| IGF502E PROCEED WITH SWAP xxx TO yyy | IGCO508E | IGC0108E | 
| | | IGC0308E | 
| | | IGCO408E | 
}------------------------------------------------------------ +----------- }-------------- { 
| IGF503I ERROR ON yyy, SELECT NEW DEVICE | IGCO508E | IGCO408E 
| | | IGCO608E | 
|------------------------------------------------------------ +----------- +-------------- { 
{| IGF504I AN ERP IS IN PROCESS FOR xxx | IGCO8O08E | IGCO408E | 
I rpspuiruaaighapvnTnSUag TNOU Sra TaD nEPpUGEINIERRDE IOUTEIESETEDETENRRRRTERREIeaTEtaTeEEEaTneImEE {-----------$--------------4 
| IGF505I SWAP FROM xxx TO yyy COMPLETE | IGCO808E | IGCO4O8E | 
| ------------------------------------------------------------ }----------- $-------------- : 
| IGF507A VOLUME ON yyy UNIDENTIFIABLE, SWAP SYSRES TO zzz | IGFDDRSR | IGFDDRSR | 
|------------------------~------------------------------------ +----------- ¢-------------- { 
| IGF508I OPERATOR SWAP CANCELLED BY SYSTEM | IGCO808E | IGCO0O08E | 
| ------------------------------------------------------------ +----------- +-------------- { 
| IGF509I SWAP xxx | IGCO508E | IGCO208E | 
| IGF509D REPLY DEVC, OR ‘'NO' | | 
poma nnn nnn nn nnn nn nnn nnn nnn nn nnn nnn nn nnn nnn a= Se $-------------- { 
| IGF509D REPLY DEVC, OR 'NO' | IGCO508E | IGCO408E | 
| | | IGCO608E | 
ben arn nnn nn nnn nnn nnn nnn nn nnn nner nen nnn nanan ann +----------- }-------------- { 
| IGF510I SYSRES RESIDENT ON xxx | IGCO508E | IGC0O108E | 
| ~--~-2----- ~<a 3 = 2 5 2-55-52 n= = 2 = === = $----------- $-------------- { 
| IGF511A WRONG VOLUME MOUNTED ON yyy | IGCO808E | IGCO608E | 
| }|----------- +-------------- { 
| {| IGFDDRSR | IGFDDRSR { 
|-----------------~------------------------------------------ +----------- +-------------- { 
| IGF512I DDR TERMINATED | IGCO808E | IGC0108E | 
| | | IGCO208E | 
| | | IGCO308E | 
| | | IGCO408E | 
|---------------------------- 4------------------------------- +----------- +-------------- { 
| IGF513I yyy INVALID FOR SWAP*# | IGcO508E | IGC0108E | 
| | | IGCO208E | 
| | | IGCO308E [ 
| | {| IGCO408E | 
Pp-—------_-----_-------_-_-_-_-__--------- - +--+ +--+ +++ --------- | ee ea Dees ee 4 
| *Messages IGF500I/D are issued for IGCO308E only if the request is for message | 
| IGF5131. | 
| | 
| **Messages IGF500I/D are always issued following a request for message IGF513I. | 
a i a ae ee ea ee a a a Se eee J 
Figure DDR-8. DDR messages 
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Ae aii Ne ye pe ee a ee ee ee er a 
| Label | Sequence Number | Action | 
passes ss ae ae ee a i ea re a a 4 
| IGF101 | 1 | | | | | Disable Allocation routine | 

-------- t---}----+----}----}----4-----------------------------------------------------{ 
| IGF111A | 2 | | | | | Find alternate SYSRES device | 
}--------- +-~-}----}----}----+----}----------------------------------------------------- { 
| IGF103 | 3 | | | | | Prepare to gain control of device | 

~------- f---}----}----4----}----} -----------------------------------------------------{ 
| IGF104 | 4 | | 16 | { 25 | Prepare for I/0 | 
j--------- t---+----+----4----+----4 | 
|] IGF105A | {| 10 | | | | | 
| |---+----+----4----+----}----------------------------------------------------- { 
| | | | 17 | | | Branch LINKRG | 
}--------- $---+----}----}----4----}----------------------------------------------------- { 
| IGF105B | 5 | 11 | | | 26 | Issue Svc 15 | 
| }---}----}----+----}----4----------------------------------------------------- { 
| | { 12 | | | | Branch LINKRG | 
}--------- }---+----}----4----+----+----------------------------------------------------- : 
| IGF106 | 6 | | | 20 | 27 | Issue WAIT | 
|--------- $---}----+----4----}----+--------------------------------------—-------------- { 
| IGF106B | | | { 21 | 28 | Branch LINKRG | 
}--------- $---+----}----}----+----}----------------------------------------------------- : 
| IGF108 | 7 | | | | | Set LINKRG1=IGF114 l 
}--------- +---}----+----}----+----4------------------------ ~---------------------------- { 
{| IGF109 | 8 | | | { | Prepare to swap UCB information | 
}--------- $---}----4----}-+---}----}----------------------------------------------------- { 
| IGF110 | 9 | l ( | | BAL LINKRG (to IGF105A) l 
| |---+----+----+----}----+----------------------------------------------------- { 
| | | 13 | | | | Branch LINKRG1 (to IGF114) | 
}--------- }---}----}----}----}----}---------------------------------------------------=+ 
{| IGF114 | | 14 | | | | Prepare to issue message IGF501D { 
|--------- }---+----4----}----}----}-----------------------=----------------------------- { 
| IGF207 | { 15 | | | | BALR LINKRG (to IGF104) | 
| }---4----+----+----}----}----------------------------------------------------- { 
| | | | 18 | | | Issue EXCP to write message | 
| |---+----+----4----4----}----------------------------------------------------- { 
| | | | 19 | | | BAL LINKRG (to IGF106) | 
| }---}----+----}----}----}----------------------------------------------------- : 
| | | | | 22 | | Check for I/O errors | 
|--------- 4---}----+----+----4----}----------------------------------------- == === === { 
| IGF300_ | | | | 23 | | Prepare to read volume ID | 
| |---4+----+----+----}----+----------------------------------------------------- : 
| | | | | 24 | | BAL LINKRG (to IGF104) | 
| |---+----4----+----}----4---------------------------------- ------------------- { 
| | { | | | 29 | Check for I/O errors | 
| }---+----+----}----4----}----------------------------------------------------- { 
| | | | | | 30 | Ensure correct volumes swapped | 
|--------- +---}----+----}----+----}----------------------------------------------------- { 
| IGF215A | | | | | 31 | Clean up DDR | 
}--------- ---}----}----4----}----}----------------------------------------------------- : 
| IGF301A | | | | | 32 | Reenable Allocation routine | 
| IGF302 | | | | | | | 
}--------- t---4$---- 4-2 -- ff =f = = nn nnn nnn nnn nn nnn nnn nnn nnn { 
| IGF303 | | | | | 33 | Return to FINCH | 
ea epee x perme) Deere! SOc ! UneeaPiNS | Upet es ices! Wes Mey ft pe Pas irom 2) gO Geese Rn mei en ye ne en 4 


Figure DDR-9. Execution sequence in IGFDDRSR for system-initiated swap of SYSRES 
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Execution sequence in IGFDDRSR for operator-initiated swap of SYSRES 


Figure DDR-10. 
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Diagnostic Aids 


DDR Section 6: 





APPENDIX A: 


MIC (MISSING INTERRUPTION CHECKER) 





WHAT MIC IS 


MIC (MisSing Interruption Checker) 
checks to see that expected I/O interrup- 
tions occur within a specified time period. 
If the interruption does not occur, the 
operator is notified so that action can he 
taken to avoid a wait that eventually 
involves the system. MIC is not a cure for 
missing interruptions, only a way of 
decreasing their impact on the entire 
system. 


HOW MIC FUNCTIONS 


For VS1, MIC (IGFTMCHK) is initiated by 
the operator with a START command and runs 
in a virtual partition. In VS2, MIC is a 
subtask of the Master Scheduler. It polls 
active I/O devices to assure that device 
and channel ends, or mount requests are 
fulfilled within a specified time period. 
This time period can be altered by reas- 
sembling the IGFINTVL CSECT with the 
desired interval, or it may be allowed to 
default to three minutes. If an I/O opera- 
tion does not complete in the specified 
time period, a message is sent to the 
operator. 


In VS2, IGFTMCHK is pageable in the 
Master Scheduler and is automatically 
invoked after the Master Scheduler is 
initialized. Diagram MIC-1 shows how MIC 
performs its function. 


MIC‘S TABLE USAGE 


MIC uses the CVTILK2 field of the CVT 
(Control Vector Table), and the following 
UCB (Unit Control Block) fields: 





FIELD BITS 

UCBFLS5 UCBTICBT 
UCBNALOC 
UCBALT PH 

UCBNAME 

UCBTBYT3 UCB3COMM 
UCB3TAPE 
UCB3DACC 

UCBSTAT UCBONLI 


The UCB fields are referenced through 
the IOSGEN macro instruction to check 
device and channel ends, and mount condi- 
tions. IOSGEN is also used to set bit 
UCBTICBT. 
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MESSAGES AND CODES 


If IGFTMCHK encounters a miSSing inter- 
ruption the following error message is 
issued: 


MOUNT 
DEVICE AND 
CHANNEL END 
CHANNEL END 
DEVICE END 


IGF991E PENDING FOR 


DEVICE ddd 


ddd=channel, unit, or address for the 
device for which the condition is 
pending. 


Operator Action: 


MOUNT 
ready the named unit. If unit is 
ready, issue the VARY ONLINE command 
to generate a pseudo device end so 
that mount processing can continue. 


CEVICE AND CHANNEL END or CHANNEL END 
a hardware malfunction has occurred. 
Terminate the affected job. The 
device named and the channel in use 
should receive maintenance. 


DEVICE END 
examine the named unit for hardware 
malfunctions such as a hang condition 
with the select light on and no tape 
motion, or a disk with the select lock 
on. Check control or switching units 
for proper connection. If the device 
was just rewound or mounted, issue a 
VARY ONLINE command to generate a 
pseudo device end. A device end at 
any other time is inadvisable, since 
the integrity of the file may be in 
doubt if the interruption is simulated, 


The following multiple console support 
(MCS) routing codes are used: 


tape - 1 and 3 
disk - 1 and 4 
unit record - 1 and 7 


In all cases a deScriptor code of 3 
(eventual action) is issued. 


HOW TO VARY THE TIME INTERVAL 


In large installations the three minute 
time interval may not be long enough to 
allow device mounts. This interval can ke 
changed ky specifying the desired interval 
through the following procedure. 


//REPLACE JOB MSGLEVEL=1 
//BRSMLK EXEC ASMFCL, PARM.LKED='REF, 
// LET, LIST, NCAL, RENT* 
//BSM. SYSIN DD 
IGFINTVL CSECT 
DC CL8*O00TTO000' 


END 
/* 
//ULKED.SYSLMOD DD DSN=SYS1.LINKLIB, 
// DIS P=OLD 
//UKED.SYSIN DD * 
INCLUDE SYSLMOD (CIGFTMCHK) 
ENTRY IGFTMCHK 
NAME IGFTMCHK (R) 
/* 


‘TT, in the DC statement, is used to 
specify the desired time interval in 
minutes. A 0, or non-numeric characters 
cause the default value of three to be 
used. 
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Where more than one page reference is 
given, the major reference is first. 


<192K Error Record Build (see IGFVMCD5) 
2192K interface to paging (see IGFVMCF6) 
<192K system, transient loading 29,30 
2192K system, transient loading 29,30 


ABREC (see MCHABREC) 
activating DDR 101 
allocation (see Device Allocation) 
ALLOCECB 102 
in IORMSCOM 133 
Alternate Path Retry Preface 
ANALYSIS 
diagram 24 
directory 37 
analyzing a channel error 64 
diagram 71 
analyzing the malfunction 8 
diagram 24 
APR (see Alternate Path Retry) 
assesSing software damage (MCH), 
diagram 25 
asynchronous interruption on which CCH 
receives control 65 
automatic recovery features 3 


BEGIN 

diagram 28 

directory 38 
buffer reconfigure bit 14 
BUFMGMT 

diagram 27 

directory 38 
building the ERPIB, diagram 72 
building the inboard record, diagram 73 
BU ILDREC 

diagram 27 

directory 38 


CATAPP 65,66,75 
CCHANTAB 87 
CCHBASE 87 
CCH base address 95 
CCH catastrophic condition 14 
(see system termination conditions) 
CCH Central (see IGFVCCHC) 
CCHCFGWD- 87 
CCH Channel Error Analysis Routine Address 
Table 78 
address of 87 
CCHCNTU 
diagram 72 
directory 84 
CCH communications scheme 74,78 
CCH data areas, locations of fields in 86 
CCH dynamic loading 77 


CCH entry indicator byte (see CATAPP) 
CCH flags (or switches) 96 
CCH functions 64 
summarized in module descriptions 79 
CCHGETRG 
diagram 71 
directory 84 
CCHHIO 66,75 
diagram 72 
directory 84 
CCH initialization 76,77 
communication scheme following a 
possible 78 
diagram 70 
module description (see IGFVCCIN) 
CCHINT 66,75 
diagram 72 
directory 84 
CCH interception-dependent routines 75 
module description 79,80 
return to I/O supervisor 
CCHINT2 65 
CCH-IOS interface 60,61, 66 
passing control to I/O supervisor 65 
returning control to CCH 65 
CCHLOGOK 
diagram 71,72 
directory 84 
CCH-MCH interface 
diagram 71 
CCH message (see IFBOO02I) 
CCH module descriptions 79 
CCHMOVE 
diagram 73 
directory 84 
CCHNOLST flag 96 
diagram 71 
CCHNORE flag 96 
diagram 71 
CCH overview 
diagram 69 
CCH parameter takle 
CCHPTTAB- 87 
CCH, purpose of 59 
CCHQUIT 
Giagran 71 
directory 84 
CCHREC 
diagram 20 
directory 38 
CCH records 
writing by MCH diagram 20 
writing by OBR 60,61 
(see also channel error inboard record) 
CCH registers 95 
CCHRETRN 
diagram 73 
directory 84 
CCHRTHIO 65 
CCHRTINT 65 
CCHRTSIO 65 
CCHRTSNN 65 


65,74 


14, 61, 66 


61,75 


78, 88 
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CCHSETFL 
diagram 73 
directory 84 
CCHSETUP 
diagram 20 
directory 38 
CCHSIO 66,75 
diagram 72 
directory 84 
CCHSNS 66,75 
diagram 72 
directory 84 
CCHSSK 66,75 
diagram 72 
directory 84 
CCHTIOSK 66,75 
diagram 72 
directory 84 
CCHTIOSN 66,75 
diagram 72 
directory 84 
CCHO0O0 
diagram 72 
directory 84 
CCH007 
diagram 73 
directory 84 
CCHOOA4KS8 
diagram 72 
directory 84 
CCH0 2860 
diagram 72 
directory 84 
CCH02870 
diagram 72 
directory 84 
CCH029A 
diagram 71 
directory 84 
CCH35 
diagram 72 
directory 84 
CCH45 
diagram 72 
directory 84 
CCH101 
diagram 71 
directory 84 
CCH102 
diagram 71,73 
directory 84 
CCH 135 Channel Error Analysis (see 
IGFVCC35) 
CCH 145 Channel Error Analysis (see 
IGFVCC45) 
CCH 155 Channel Error Analysis (see 
IGFVCC55) 
CCH 2860 Channel Error Analysis (see 
IGFVCC60 ) 
CCH 2870 Channel Error Analysis (see 
IGFVCC70) 
CCH 2880 Channel Error Analysis (see 
IGFVCC80) 
CcW, translating virtual to real, 
diagram 73 
channel configuration word 74 
address of 87 
channel error inboard record 60,93 


146 


address of 95 
address of area _ 87 
building diagram 73 
why none availakle 67 
channel error processing by I/0 
Supervisor 60 
channel logout 59 
successfully logged out 66 
Channel Restart 136 
channels 
storage needed for CCH support 63 
Supported by CCH 59 
channel status word 40 
CHANSUPT 
diagram 70 
directory 84 
CKSYNTAX, directory 37 
codes expected in register 7 from 
NSLREPOS 105 
coding NSLREPOS 104 
COMBUI LD 
diagram 28 
directory 37 
Command Router (see IGC0403D) 
COMMEXIT 
Giagram 27 
directory 38 
communications scheme (see CCH 
communications scheme) 
Communications Task TCB, diagram 27 
conditions causing hard machine-check 
interruptions 5 
Console Write (see IGFVMCE1) 
control register 14 4,5 
diagram 23 
control register 15 4,9,10 
control storage 3 
CON80 
diagram 71,72 
directory 84 
CTRLPROG macro instruction 100 
CVT address 
for CCH 95 
for DDR 138 


Damage Repair (see IGFVMCF2) 
DDR Abnormal End Appendage (see IGFVDDR3) 
DDR kase address 138 
DDR Central (see IGE0660A) 
DDR Channel End Appendage (see IGFVDDR2) 
DDR communications area (see IORMSCOM) 
DDR control 101 
diagram 110-111 
DDR control flow 101 
DDR data area (see IORMSCOM) 
DDRECB 
being waited on 101,102 
diagram 108,109 
directory 130 
DDR execution 101 
Giagram 112-117 
DDR functions 101 
summarized in module descriptions 122 
CDR-I0S interface 102 
DDR messages 139 
CDR module descriptions 122 
DDR modules in nucleus 118 


DDR modules in SVC transient area 118 
DDRNSL 100 
DDR overview, diagram 107 
DDR, purpose of 99 
DDRRB 
Giagram 110-111 
directory 129 
DDR Recording (see IGC0708E) 
DDR Resident (see IGFDDRMF for VS1, 
IGFDDRMV for VS2) 
DDR Router (see IGC0008E) 
DDR support 99 
DDR SYSRES (see IGFDDRSR) 
DDR verification 101 
diagram 109 
DDR wait queue 101,102 
address of 138 
diagram 112 
Device Allocation 102 
diagram 110 
device-dependent ERP (see ERP) 
devices supported by DDR 99 
diagrams 
CCH 69-73 
DDR 107-117 
how to read 16,68,106 
MCH 17-28 
direct access devices supported by DDR 99 
disable interruptions 7 
diagram 23 
disk ERP 102,103 
dynamic loading 74,77 


ECC (see Error Checking and Correction) 
ECSW 40,59,90-93 

diagram 72 

successfully stored 66 
emergency error recording 14,15 
Emergency Recorder (MCH) (see IGFVMCE3) 
emulator 7-track tapes supported by DDR 99 
enable interruptions 8 

diagram 23 
EREP 59 
ERP 59,60 

possible exits 62 
ERPIB 59,64,88 

building 

diagram 71 

clearing 62 

table 64,78 

why none available 67 
ERPIBAD 87 
ERPIBSET 74 

module description 80 
ERPIB table 64,78 

address of 87 
Error Checking and Correction 3 
Error Record Build 29 

diagram 27 

directory 38 
error records (see MCH records or CCH 
records) 
error recovery, MCH levels of 5 
error recovery procedure (see ERP) 
execution sequence in IGFDDRSR 140,141 
EXERCISE 

diagram 24 


directory 37 
EXPRESS 

diagram 24 

directory 37 
Extended Channel Status Word (see ECSW) 
extended logout area 4,8 

pointer to 9,10 

sizes 5 


Fetch 102,103 

FINCH 103 
diagram 116 

fixed logout area 4,5 
address in RVTINLOG 49 


Sizes 5 
fixed storage areas used by MCH 3,4,40 
FLAG 87 


flags, CCH (see CCH flags) 
flow through IGFDDRSR 140,141 
FORMSTAT, directory 37 
functions of 
CCH 64 
Summarized in module descriptions 79 
DDR 101 
summarized in module 
descriptions 122 
MCH 7 
summarized in module descriptions 32 


general processing, MCH 29-31 
generating DDR 100 
GETRESIZ 

diagram 70 

directory 84 


Halt I/O, module description 80 
hard machine-check interruption 5,8,29 
conditions causing 5 
diagram 24 
general processing of 31 
hard stop 8 
Hardware Error Analysis (see IGFVMCD1) 
Hardware Instruction Retry 3 
HIPO diagrams (see diagrams) 
History Table (see MCH History Table) 
HIR (see Hardware Instruction Retry) 


IEAANIPO, diagram 18 
IEANUCO1, directory 129 
IFBOO2I message 60 
IFCEREPO utility (see EREP) 
IGBLAME' 88 
IGCOOO8E 

diagram 110-111 

directory 129 

module description 122 
IGC0O108E 

diagram 110-111 

directory 129 

module description 123 
IGCO 208E 

diagram 112-113 

directory 129 

module description 123 
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IGCO308E 
diagram 112-113 
directory 129 
module description 124 
IGCO4O8E 
diagram 112-115 
directory 129 
module description 124 
IGCO403D 101 
IGCO508E 
diagram 112-115 
directory 129 
module description 125 
IGCO0608E 
diagram 112-115 
directory 129 
module description 125 
IGC0708E 
diagram 112-115 
directory 129 
module description 126 
IGCO808E 
diagram 112-115 
directory 129 
module description 126 
IGC0908E 
directory 129 
module description 126 
IGC2603D 
directory 37 
module description 36 
IGEO660A 101 
diagram 108 
directory 129 
module description 126 
IGFDDRFC 
diagram 110-111 
directory 129 
IGFDDRMF 
diagram 110-111 
directory 129 
module description 127 
waiting on DDRECB 101 
IGFDDRMV 
diagram 110-111 
directory 130 
module description 127 
waiting on DDRECB i101 
IGFDDRND 
Giagram 110-111 
directory 129 
IGFDDRSR 102,103,137,140,141 
diagram 116-117 
directory 130 
module description 127 
IGFDDRO1 
Girectory 129 
IGFDDRO5S 102 
directory 130 
IGFDDR11 
directory 129 
IGFERRO 
diagram 20 
Girectory 37 
IGFNO0000 
diagram 23 
directory 37 
IGFVCCHC 74,76 
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diagram 71-73 
directory 84 
module description 
return to 95 
IGFVCCIN 74-77 
diagram 70 
directory 84 
module description 
IGFVCC35 74,76 
diagram 72,73 
directory 84 
module description 
IGFVCC45 74,76 
diagram 72,73 
directory 84 
module description 
IGFVCC55 74,76 
diagram 72 
directory 84 
module description 
IGFVCC60 74,76 
diagram 71-73 
directory 84 
module description 
IGFVCC70 74,76 
diagram 71-73 
directory 84 
module description 
IGFVCC80 74,76 
diagram 71-73 
directory 84 
module description 
IGFVDDR2 102 
directory 130 
module description 
IGFDDR3 
directory 130 
module description 
IGFVMCDO 29 
diagram 22 
directory 37 
module description 
IGFVMCD1 
diagram 24 
directory 37 
module description 
IGFVMCD2 
diagram 24 
directory 37 
module description 
IGFVMCD3 
diagram 24 
directory 37 
module description 
IGFVMCD4 
directory 37 
module description 
IGFVMCD5 29 
directory 37 
IGFVMCEO 
diagram 20, 23,24 
directory 37 
module description 
IGFVMCE1 
directory 37 
module description 
IGFVMCE2 
diagram 28 


79 


79 
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83 


83 


81 


82 


82 
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32 


32 


32 


33 


36 


33 


34 


directory 37 

module description 34 
IGFVMCE3 14,29 

Giagram 20 

directory 38 

module description 34 
IGFVMCE4 29 

diagram 21 

directory 38 

module description 34 
IGFVMCE5 29 

diagram 27 

directory 38 

module description 35 
IGFVMCFO, diagram 18 
IGFVMCF1 

diagram 25 

directory 38 

module description 35 
IGFVMCF 2 

diagram 26 

directory 38 

module description 35 
IGFVMCF3 

directory 38 

module description 35 
IGFVMCF4 

diagram 26 

directory 38 

module description 36 
IGFVMF6 29 

directory 38 
IGFVNIP 74,77,79 

diagram 70 
IGFSTAE, directory 130 
IGFODEB, directory 130 
IGFOIOB, directory 130 
IGF101 140,141 
IGF102 141 
IGF103 140,141 
IGF1i04 140,141 
IGF105 141 
IGFi05A 140,141 
IGF105B 140,141 
IGF106 140,141 
IGF106B 140 
IGF107 141 
IGF108 140,141 
IGF109 140,141 
IGF110 140,141 
IGF111A 140 
IGF114 140,141 
IGF201, directory 129 
IGF207 140,141 
IGF215A 140,141 
IGF300 140,141 
IGF301A 140,141 
IGF302 140,141 
IGF303 140,141 
IGF4O0, directory 130 
IGF2503D 101 

diagram 109 

directory 130 

module description 128 
IiGF910W message, possible problems 
indicated by 53 
IGPRGLFG 88 
IGTERMSQ _ 89 


IGUCB 88 
IGVALIDB 89 
inboard record (see channel error inboard 
record) 
indispensible system task 11 
initialization 
CCH 62,63,74,77 
diagram 70 
directory 84,129 
MCH 
diagram 18 
instruction processing damage 10 
interception-dependent routines (see CCH 
interceptions-dependent routines) 
intermittent failures 10,11 
IOB address for DDR 139 
I/O communications area 4 
I/O extended logout pointer 40 
IORMSCOM 101,133 
address of 138 
CCH portion 74,78 
directory 130 
locations of fields in 132 
I/O RMS communications area (see IORMSCOM) 
IORMSSVC 
diagram 110-111 
directory 129,130 
IORMSWT 
Giagram 110-111 
directory 129,130 
IORTN 
diagram 20 
directory 38 
I0S-CCH interface (see CCH-IOS interface) 
IOS channel error processing 60 
IOS-DDR interface (see DDR-IOS interface) 
IOS-DDR vector table 136 
IOSVTA 134 
pointer to 102 
IOS normal I/O processing 60 
IPL and NIP Logic, referred to 74 
diagram 70 


levels of error recovery 5 
library 
CCH directory 84 
DDR directory 129 
MCH directory 36 
limited channel logout 40 
IOAD CONTROL instruction 4 
loading transient modules 29 
diagram 20 
locations of 
channel logout areas 59 
fields in CCH data areas 86 
fields in IORMSCOM 132 
fields in MCH data areas 47 
location 115 (machine-check new PSW) 66 
Logout area sizes 
CCH 59 
MCH 5 
(see also fixed logout and extended 
logout) 
long record (see MCH long record) 
"lost summary" field 14 


Index 149 


machine-check interruption 3,7 
during CCH processing 14,66 
immediately after MCH is entered 8 
processing, diagram 19 
unrecoverable conditions 14 
(see also hard machine-check 
interruptions and soft machine-check 
interruptions) 
machine-check interruption code 
machine-check new PSW 7 
Machine-check old PSW 7,15 
address of in MCHRPSW 45 
machine recovery features 3 
machine status block 51 
Main Storage Analysis (see IGFVMCD2) 
MASTRBYT, diagram 70 
diagram 70 
MCEL bit 4 
MCHABREC 13 
diagram 27,28 
MCHBUILD, diagram 28 
MCH-CCH interface 
in CCH 61,66 
diagram 71 
in MCH 14 
MCH common area _ 43 
MCHDAMAG 13,14, 43 
MCH data areas, locations of fields in 39 
MCH Emergency Recorder (see IGFVMCE3) 
MCH Error Recorder (see IGFVMCE2) 
MCHERTST 
diagram 23 
directory 37 
MCHEXLEV 53,54 
MCH functions 8 
summarized in module descriptions 32 
MCH History Table 53,54 
MCHHISTY 53,54 
MCH independent common area (see MCH common 
area) 
MCH initialization, diagram 18 
MCH I/O Control (see IGFVMCE4) 
MCH logic 7 
MCHLONG, diagram 27,28 
MCH long record 13,14,52 
(see also MCHLONG) 
MCH messages 53,54,55 
MCH module descriptions 32 
MCH Nucleus (see IGFVMCE0) 
MCHNXHIS 53,54 
diagram 21 
MCH overlay structure 7,29 
MCH overview 3,4 
diagram 17 
MCHPSA’ 8,46 
MCH, purpose of 3 
MCH Record Build Area 13 
MCH records 
building 
Giagram 27 
emergency 14,15 
diagram 20 
formats 13 
recording 13 
diagram 28 
(see also MCH long record and MCH short 
record) 
MCH Recovery Vector Takle 


10,40,41 


49,66 
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MCH registers 53 
MCHRPSW 8,45 
MCH Short record 13,14 
(see also MCHABREC) 
MCH transient modules 
diagram 21 
loading of 30 
MCH wait state codes 54-55 
MCI (see machine-check interruption) 
MCIC (see machine-check interruption code) 
MCICCK 
diagram 24 2 
directory 37 
MCIVALD 
diagram 24 
directory 37 “ 
Message Writer I (see IGC0O508E) 
Message Writer II (see IGCO808E) 
message IFBOO2I 60 


messages 
DDR 139 
MCH 54-55 


method of operation diagrams (see diagrams) 
Missing Interruption Handler (MIH) 142 
mode 5 
mode command, diagram 22 
Mode Command Processor (see IGC2603D) 
Model 165, unrecovered malfunctions 10 
MODESWCH 
Giagram 22 
directory 37 
MODs (see diagrams) 
MOVE 
diagram 73 
directory 84 
MOVEDA 
diagram 28 
directory 37 
MOVELOG 
diagram 73 
directory 84 
MSGWRITE 
diagram 20 
directory 37 
multiple bit error 3,10 
NC LRECOK 
diagram 20 
directory 37 
NIP 77 
NOCONSL 
diagram 20 , 
directory 37 
nonpageakle area 11 
non-standard tape label processing for 
DDR 100,104,105 v 
"no retry” bit 62,64 
NSLREPOS 104 


OBR (see Outkoard Recorder) 
Operator-Initiated DASD DDR 
operator-initiated swap requests 
diagram 109,114-115 
for SYSRES 141 
Operator-Initiated Tape DDR (see IGCO408E) 
Outboard Recorder 60,61,101 
overlay structure (see MCH overlay 


(see IGC0108E) 
101,121 
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structure) 
overview 
of CCH 
diagram 69 
processing 75 
of CCH-MCH-IOS processing of I/0 
errors 61 
of DDR 
diagram 107 
of MCH 3,4 
diagram 17 


pageable area 11 
Page Frame Table Entry, diagram 25 
Page Table Entry, diagram 26 
Paging Queue Area i11 
Paging Supervisor 29 
parameter table (see CCH parameter table) 
permanent errors 

channel 60,62 

DDR requested after 99 

machine check 3 

supported by DDR 100 
permanent storage assignment 3 
PFTE (see Page Frame Table Entry) 
PQA (see Paging Queue Area) 
preservation of the system environment by 
MCH 7 
processor damage 10 
processor failures i11 
program-check new PSW 53 
program-check old PSW 40 
Program Fetch (see Fetch) 
PTE (see Page Table Entry) 
purpose of 


CCH 59 
DDR 99 
MCH 3 


quiet mode 5 
QMODE, directory 37 


READY 
diagram 28 
directory 37 
real page i1 
diagram 26 
real storage failures 11 
recording mode 5 
records (see CCH records or MCH records) 
RECORD1 87 
recovery vector table (see MCH Recovery 
Vector Table) 
register usage 


CCH 95 
DDR 138 
MCH 5 


(see also control register 14 and 
control register 15) 

repair bit 14 

repositioning tapes without standard 

labels 104 

restrictions on DDR support 99 

retry by DDR after swap 105 

retry of I/O operation that caused channel 


error 60,61 
return to IGFVCCHC 95 
RMODE, directory 37 
RQE 
address for DDR 138 
used by ERP 61 
use with DDR wait queue 101 
RVT (see MCH Recovery Vector Table) 


RVTCCHRC 15,49 
RVTINLOG 8,50 
RVTWSFLG 66 
RVTWSMCC 14,49 
second MCI 7,11 


Sense routine 
example 64 
module description 80 
SEREP 66 
sequence codes 89 
diagram 72 
SERRO4Y 65 
SETCHMSG 
diagram 20 
directory 37 
Short record (see MCH short record) 
SHUT routine 7,9,14 
Single-bit error 3 
SMCH (see IGFVMCDO) 
Soft Machine-Check Handler (see IGFVMCDO) 
soft machine-check interruption 5,29 
diagram 24 
general processing 30 
sOlid failures 10,11 
Special Handler for Unusual Termination 
(see SHUT routine) 
SPF Key Analysis (see IGFVMCD5) 
SPF Key error 11 
SQA (System Queue Area) 11 
Statistics Update routine 
storage areas, fixed 3,4 
storage assignment, permanent 3 
storage errors’ 8,10 
storage reconfigure bit 14 
storage requirements, CCH 63 
STORE CHANNEL ID instruction 74 
diagram 70 
STORE CONTROL instruction 4 
STORE CPU ID instruction 74 
diagram 70 
STOREID 
diagram 108 
directory 84 . 
Subsystem Interface (see IGFVMCF3) 
successor module 53 
Supervisor state 99 
Svc Purge routine 102 
SVcO0O, diagram 28 
SvC 2, diagram 11 
Svc 3 (EXIT) 
diagram 20,108,109,110 
used by ERP 62 
used by Outboard Recorder 60 
used ty SVC 85 102 
Svc 7 (XCTL) 
Giagram 109,110,112,114 
Svc 85 102 
SVC 15 (ERREXCP) 


60,72 
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used by DDR 99,102,105 
used by ERP 62 
SVC 85 (DDR) 102,120,121 
SVRB address for DDR 138 
SWAP command 103,104,101 
diagram 109 
SWAP Command Processor (see IGF2503D) 
“swapped to itself" 99 
Switches, CCH (see CCH flags) 
SYSFLG1 137 
SYSRES 99,101,103,140,141 
diagram 116 
System Analysis (see IGFVMCF1) 
System damage 10 
System Environment Recording Interface 
routine 65 
System-Initiated DDR I (see IGC0208E) 
System-Initiated DDR II (see IGC0308E) 
system-initiated swap reguests 101,120 
Giagram 108,112 
for SYSRES 140 
system recovery 6 
diagram 26 
system repair 6 
System residence volume supported by DDR 
(see SYSRES) 
system-supported restart 6 
system termination conditions (CCH) 
diagram 71 
System/370 Principles of Operation, 
referred to 3,5 
System/370 recovery facilities 3 
SYSTERM flag 96 
diagram 71,73 
SYS1.LINKLIB 74,77 


directory 37,38,84 
SYS1.LOGREC 

CCH records 59,60, 66 

MCH records 4,14 


diagram 28 
SYS1.LOGREC DCB 74,78 
SYS1.LPALIB 102 
SYS1.SVCLIB 29,102,104 
directory 37,38,129,130 


tape drives supported by DDR 99 
Tape Label Verifier (see IGC0608E) 
Tape Labels, referred to 105 
task recovery 6 

diagram 26 
TCB address for DDR 138 
teleprocessing devices supported by DDR 99 
tense 8,10 
terminating the system, diagram 26 
termination bit 14 
termination codes 89 

diagram 72 


152 


Terminator (see IGFVMCF4) 
TESTIPD 

diagram 24 

directory 37 
TESTRESW 

diagram 73 

directory 84 
TESTEXT 

diagram 24 

directory 37 
TEST1 

diagram 28 

directory 37 
TEST2 

diagram 28 

directory 37 
threshold 5 

diagram 22 
transient modules 

diagram 20 

loading of 29,30 
TSO 104 
TSTTIME 

diagram 24 

directory 3/7 
TSTTODC 

diagram 24 

directory 37 


UCB addresses 
address list 104 
diagram 112 
FROM UCB 138 
TO UCB 138 
used by CCH 61 
UCB information exchanged by DDR 104 
UCBNRY 104 
UCBSCH 
diagram 73 
directory 84 
UCB Search routine 65, 66,74, 76 
module description 81 
unit address needed by CCH 95 
unit check with sense information 100 
unit-record devices supported by DDR 99 


validity 10 
vector table (see IOS-DDR vector table) 


wait state 9,15,66 
codes 54,55 
warm Start 6 
work ERPIB 64 
writing an error record, diagram 28 
WTO (Write-to-Operator) 60,62 
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will be sent to the author’s department for appropriate action. Using this 

form to request system assistance or additional publications will delay response, 
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